← Back to schema index

LookupAccountDirectoryResponse

Response from `GET /v1/account-directory/lookup?last_digits=`. Most recent entry from the global account catalog whose suffix matches the given digits. **Does not include `account_number`** — only the bank and the last-seen timestamp, to prevent catalog enumeration.

Properties

FieldTypeDescription
dataobjectMain response payload. Shape varies by endpoint (object, array, or JSON:API envelope with `type`, `id`, `attributes`).
type*stringJSON:API resource type. Always `account_directory_lookup`.
attributes*objectCanonical attributes of the directory entry (resolved bank and last-seen timestamp).
account_type*stringAccount type inferred for the catalog entry. `clabe` — 18-digit CLABE; `card` — 16-digit card; `phone` — 10-digit phone.
bank_code*string | null5-digit Banxico SPEI code. `null` when the entry has no resolved bank (e.g. unknown BIN).
bank_name*stringBank name for the catalog entry.
last_seen_at*string (date-time)ISO 8601 UTC timestamp of the latest observation of the account.
metaobjectResponse metadata including API version, route prefix, unique request identifier, and the server timestamp in UTC.
versionstringAPI version that processed the request.
api_versionstringAPI route prefix version (e.g. `v1`).
request_idstringUnique request identifier (hex).
datetimeobjectCompanion 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*stringAlways `UTC` — the canonical timezone for every datetime field in the body.
format*stringAlways `ISO 8601` — explicit `Z` suffix on every datetime.
linksobjectPagination or related links, present only when the endpoint returns a paginated collection.

Used in operations

  • GET /v1/account-directory/lookup