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

Codes and list of participant banks

Audience: public

Returns the current catalog of banking institutions participating in the SPEI system. 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 a previous response, sent as is (weak `W/"…"` on a validation, strong on the public catalogs). If the resource has not changed, the server responds `304 Not Modified` (no body) and avoids sending the data again. e.g. `"9b2d4c7e1f0a3b6d8e5c2a7f4b1d9e0c3a6f8b2d"`

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. `a1b2c3d4e5f66f5e4d3c2b1a`
`datetime`	`object`	Companion descriptor present in the `meta` block of every response (and in the `meta` of outgoing webhook bodies). 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.