`ValidateAccountResponse`

Response from `GET /v1/beneficiaries/validate-account?account=`. Structural result for an account number. Under `data.attributes` it reports the detected type, the checksum, the resolved bank metadata (when possible) and, for 17-digit partial CLABEs, the auto-completed form. This endpoint does **not** call Banxico — purely local validation.

Properties

Field	Type	Description
`data`	`object`	Main response payload. Shape varies by endpoint (object, array, or JSON:API envelope with `type`, `id`, `attributes`).
`type`*	`string`	JSON:API resource type. Always `account_validation`.
`attributes`*	`object`	Structural validation result.
`input`*	`string`	Raw input as received (un-normalized).
`length`*	`integer`	Length in digits of the normalized input.
`is_numeric`*	`boolean`	`true` when the raw input contained only digits (no separators).
`account_type`*	`string`	Account type detected by length, or `unknown` for partial inputs or out-of-range lengths. The recognised types are `clabe`, `card`, and `phone`.
`is_complete`*	`boolean`	`true` when the input is complete for its type (18 digits for CLABE, 16 for card, 10 for phone).
`checksum_valid`*	`boolean`	`true` when the CLABE control digit verifies, or the card Luhn checksum is valid. For phone always `false` (not applicable).
`computed_control_digit`	`string \| null`	CLABE control digit computed from the first 17 digits. `null` when the type is not CLABE or the calculation does not apply.
`auto_completed`	`string \| null`	18-digit auto-completed CLABE when the input arrived with 17 digits and the control digit could be calculated. `null` otherwise.
`bank`	`object \| null`	Resolved bank metadata, or `null` when the bank could not be identified. For CLABE derived from the prefix; for card derived from the BIN.
`banxico_code`	`string \| null`	5-digit Banxico SPEI code when the bank is mapped.
`name`	`string`	Bank name.
`card`	`object \| null`	Additional BIN metadata when `account_type=card` and the BIN matched the directory. `null` otherwise.
`bin`	`string`	Queried BIN prefix.
`brand`	`string \| null`	Card brand (Visa, Mastercard, etc.).
`type`	`string \| null`	Card type (`debit`, `credit`, etc.).
`level`	`string \| null`	Card level (`classic`, `gold`, etc.).
`country_iso`	`string \| null`	ISO 3166-1 alpha-2 of the issuing country.
`meta`	`object`	Response metadata including API version, route prefix, unique request identifier, and the server timestamp in UTC.
`version`	`string`	API version that processed the request.
`api_version`	`string`	API route prefix version (e.g. `v1`).
`request_id`	`string`	Unique request identifier (hex).
`datetime`	`object`	Companion descriptor present in every response's meta block (and in outgoing webhook payloads). Lets clients assert the timezone contract without re-reading the spec.
`timezone`*	`string`	Always `UTC` — the canonical timezone for every datetime field in the body.
`format`*	`string`	Always `ISO 8601` — explicit `Z` suffix on every datetime.
`links`	`object`	Pagination or related links, present only when the endpoint returns a paginated collection.

Used in operations

GET /v1/beneficiaries/validate-account