`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
`type` *	`string`	JSON:API resource type.
`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.
`is_complete` *	`boolean`	`true` when the input is complete for its type (18 digits for CLABE, 13–19 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.

Variants

`allOf`

SuccessEnvelope
object

Used in operations

GET /v1/beneficiaries/validate-account