← Back to schema index

RetryAttempt

Record of an individual automatic retry attempt. Returned in the `attempts` array from `GET /v1/validations/{id}/retry-attempts`.

Properties

FieldTypeDescription
attempt_numberintegerSequence number of the attempt (1-based).
dispatched_atstring (date-time)ISO 8601 timestamp in UTC with explicit `Z` suffix. Example: `"2026-05-01T05:14:38Z"`. Every datetime field uses this shape. The descriptor at `meta.datetime` makes the contract runtime-assertable.
started_atstring (date-time)ISO 8601 timestamp in UTC with explicit `Z` suffix. Example: `"2026-05-01T05:14:38Z"`. Every datetime field uses this shape. The descriptor at `meta.datetime` makes the contract runtime-assertable.
finished_atstring (date-time)ISO 8601 timestamp in UTC with explicit `Z` suffix. Example: `"2026-05-01T05:14:38Z"`. Every datetime field uses this shape. The descriptor at `meta.datetime` makes the contract runtime-assertable.
prev_banxico_statusstringBanxico status of the validation immediately before this attempt (e.g. `not_found`). The verdicts are `valid`, `not_found`, `cep_unavailable`, `invalid`, and `error`.
new_banxico_statusstring | nullBanxico status after the attempt completed. `null` if the attempt did not receive a Banxico response (e.g. network failure). The verdicts are `valid`, `not_found`, `cep_unavailable`, `invalid`, and `error`.
prev_statusstringValidation status before the attempt. The states are `queued`, `processing`, `valid`, `not_found`, `cep_unavailable`, `invalid`, `failed`, and `error`.
new_statusstring | nullValidation status after the attempt. `null` if the attempt did not produce a state transition. The states are `queued`, `processing`, `valid`, `not_found`, `cep_unavailable`, `invalid`, `failed`, and `error`.
processing_time_msinteger | nullProcessing time for the attempt in milliseconds. `null` if the attempt did not complete.
error_codeValidationErrorCode | nullError code if the attempt ended in failure. See `ValidationErrorCode` for possible values. `null` if the attempt completed without error.
proxy_pool_memberstring | nullIdentifier of the proxy used for this attempt. Useful for diagnosing repeated failures on the same node.

Used in operations

  • GET /v1/validations/{id}/retry-attempts