Listar los bancos participantes con su código

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

Audiencia: public

Devuelve el catálogo actual de instituciones bancarias participantes del sistema SPEI. El catálogo es actualizado semanalmente desde las listas oficiales del Banco de México (Banxico).

El atributo code identifica a cada institución bancaria.

La lista es cacheable: Incluye la cabecera ETag, la cual puede ser enviada en otra petición como If-None-Match; si el catálogo no ha cambiado, retorna un código HTTP 304 (sin cuerpo).

Parámetros
Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`If-None-Match`	header	`string`	opcional	ETag recibido en peticiones anteriores. Si los datos no han cambiado y el `etag_version` sigue igual, el server responde `304 Not Modified` (sin cuerpo) — evita recibir los datos de nuevo cuando el estado del recurso NO ha cambiado. p. ej. `W/"3-processing"`

Petición

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;

**Respuesta 200**`ListBanksResponse` — Catálogo completo de instituciones participantes del sistema SPEI.
Campo	Tipo	Descripción
`data`	`array`	Payload principal de la respuesta. La forma varía según el endpoint (objeto, array, o envelope JSON:API con `type`, `id`, `attributes`).
`type`*	`string`	Tipo del recurso API (`bank` por defecto). p. ej. `bank`
`id`*	`string`	Código bancario de la institución (5 dígitos). p. ej. `40012`
`attributes`*	`object`	Atributos de la institución bancaria.
`code`*	`string`	Código bancario de la institución (5 dígitos). Mismo valor que `id`. p. ej. `40012`
`name`*	`string`	Nombre oficial de la institución bancaria. p. ej. `BBVA MEXICO`
`aliases`	`array`	Nombres alternativos (marca/abreviaturas) de la institución bancaria. p. ej. `["bancomer","bbva bancomer"]`
`meta`	`object`	Metadatos 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.
`version`	`string`	Versión de la API que procesó la petición. p. ej. `1.47.0`
`api_version`	`string`	Versión del prefijo de ruta de la API (ej. `v1`). p. ej. `v1`
`request_id`	`string`	Identificador único de la petición (hex). p. ej. `a1b2c3d4e5f6`
`datetime`	`object`	Descriptor 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. p. ej. `{"timezone":"UTC","format":"ISO 8601"}`
`timezone`*	`string`	Siempre `UTC` — la zona canónica para cada campo datetime del cuerpo. p. ej. `UTC`
`format`*	`string`	Siempre `ISO 8601` — sufijo `Z` explícito en cada datetime. p. ej. `ISO 8601`
`links`	`object`	Enlaces de paginación o relacionados, presentes solo cuando el endpoint devuelve una colección paginada.

**Códigos de respuesta**`GET /v1/public/banks`
Código	Clase	Descripción	Cuerpo
200	`2xx`	Catálogo completo de instituciones participantes del sistema SPEI.	`ListBanksResponse`
304	`3xx`	No modificado — los datos no han cambiado según el ETag enviado.	Sin cuerpo

**Cabeceras de respuesta**`200`
Cabecera	Tipo	Descripción
`Cache-Control`	`string`	TTL de caché en el cliente (1 h).
`ETag`	`string`	Firma de la petición actual. Pasar como `If-None-Match` en peticiones posteriores.