Codes and list of participant banks

GEThttps://api.veriko.mx/v1/public/banks

Audience: public

Returns the current catalog of banking institutions participating in the SPEI system (~95 institutions). The catalog is updated weekly from the official lists of the Bank of Mexico (Banxico).

The code identifies each banking institution participating in the SPEI system.

The response is cacheable: it includes the ETag header, which can be sent in another request as If-None-Match; if the catalog has not changed, it returns 304 (no body).

Parameters
Parameter	In	Type	Required	Description
`If-None-Match`	header	`string`	optional	ETag received in previous requests. If the data has not changed and `etag_version` is still the same, the server responds `304 Not Modified` (no body) — avoids receiving the data again when the resource state has NOT changed. e.g. `W/"3-processing"`

Request

cURLPythonJavaScriptPHP

curl -X GET 'https://api.veriko.mx/v1/public/banks'

import requests

response = requests.get("https://api.veriko.mx/v1/public/banks")
print(response.json())

fetch("https://api.veriko.mx/v1/public/banks")
  .then(response => response.json())
  .then(data => console.log(data));

<?php

$ch = curl_init("https://api.veriko.mx/v1/public/banks");

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

echo $response;

**Response 200**`ListBanksResponse` — Full catalog of participant institutions in the SPEI system.
Field	Type	Description
`data`	`array`	Main response payload. Shape varies by endpoint (object, array, or JSON:API envelope with `type`, `id`, `attributes`).
`type`*	`string`	API resource type (`bank` by default). e.g. `bank`
`id`*	`string`	5-digit code of the banking institution. e.g. `40012`
`attributes`*	`object`	Attributes of the banking institution.
`code`*	`string`	Code of the banking institution (5 digits). Same value as `id`. e.g. `40012`
`name`*	`string`	Official name of the banking institution. e.g. `BBVA MEXICO`
`aliases`	`array`	Alternative names (brand/abbreviations) of the banking institution. e.g. `["bancomer","bbva bancomer"]`
`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. e.g. `1.47.0`
`api_version`	`string`	API route prefix version (e.g. `v1`). e.g. `v1`
`request_id`	`string`	Unique request identifier (hex). e.g. `a1b2c3d4e5f6`
`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. e.g. `{"timezone":"UTC","format":"ISO 8601"}`
`timezone`*	`string`	Always `UTC` — the canonical timezone for every datetime field in the body. e.g. `UTC`
`format`*	`string`	Always `ISO 8601` — explicit `Z` suffix on every datetime. e.g. `ISO 8601`
`links`	`object`	Pagination or related links, present only when the endpoint returns a paginated collection.

**Response status codes**`GET /v1/public/banks`
Status	Class	Description	Body
200	`2xx`	Full catalog of participant institutions in the SPEI system.	`ListBanksResponse`
304	`3xx`	Not modified — the data has not changed per the sent ETag.	No body

**Response headers**`200`
Header	Type	Description
`Cache-Control`	`string`	Client cache TTL (1 h).
`ETag`	`string`	Fingerprint of the current request. Pass as `If-None-Match` on subsequent requests.