← Volver al índice de esquemas

LookupAccountDirectoryResponse

Respuesta de `GET /v1/account-directory/lookup?last_digits=`. Entrada más reciente del catálogo global de cuentas cuyo sufijo coincide con los dígitos enviados. **No incluye `account_number`** — solo el banco y la fecha de última observación, para evitar enumeración del catálogo.

Propiedades

CampoTipoDescripción
dataobjectPayload principal de la respuesta. La forma varía según el endpoint (objeto, array, o envelope JSON:API con `type`, `id`, `attributes`).
type*stringTipo del recurso JSON:API. Siempre `account_directory_lookup`.
attributes*objectAtributos canónicos de la entrada del directorio (banco resuelto y última observación).
account_type*stringTipo de cuenta inferido para la entrada del catálogo. `clabe` — CLABE de 18 dígitos; `card` — tarjeta de 16; `phone` — teléfono de 10.
bank_code*string | nullCódigo Banxico SPEI de 5 dígitos. `null` cuando la entrada no tiene banco resuelto (p. ej. BIN desconocido).
bank_name*stringNombre del banco asociado a la entrada del catálogo.
last_seen_at*string (date-time)Timestamp ISO 8601 UTC de la última observación de la cuenta.
metaobjectMetadatos de la respuesta, incluyendo versión de la API, prefijo de ruta, identificador único de la petición y marca temporal del servidor en UTC.
versionstringVersión de la API que procesó la petición.
api_versionstringVersión del prefijo de ruta de la API (ej. `v1`).
request_idstringIdentificador único de la petición (hex).
datetimeobjectDescriptor compañero presente en el bloque `meta` de cada respuesta (y en el `meta` del cuerpo de los webhooks salientes). Permite a los clientes afirmar el contrato de zona horaria sin releer el spec.
timezone*stringSiempre `UTC` — la zona canónica para cada campo datetime del cuerpo.
format*stringSiempre `ISO 8601` — sufijo `Z` explícito en cada datetime.
linksobjectEnlaces de paginación o relacionados, presentes solo cuando el endpoint devuelve una colección paginada.

Usado en operaciones

  • GET /v1/account-directory/lookup