← Back to schema index

ListBanksResponse

Response from `GET /v1/public/banks`. Full SPEI participant catalog (~95 active institutions). ETag-cacheable — the snapshot updates weekly when the Banxico sync refreshes the catalog.

Properties

FieldTypeDescription
dataarrayMain response payload. Shape varies by endpoint (object, array, or JSON:API envelope with `type`, `id`, `attributes`).
type*stringAPI resource type (`bank` by default).
id*string5-digit code of the banking institution.
attributes*objectAttributes of the banking institution.
code*stringCode of the banking institution (5 digits). Same value as `id`.
name*stringOfficial name of the banking institution.
aliasesarrayAlternative names (brand/abbreviations) of the banking institution.
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/public/banks