Listar bancos SPEI

GET https://api.veriko.mx/v1/public/banks

Listar bancos SPEI

Audiencia: public

Devuelve el catálogo actual de participantes SPEI (~95 instituciones) desde el snapshot local mantenido por el sincronizador semanal. Usado por el combobox de selección de banco en el alta de beneficiarios tipo celular (DiMo) y en el modal de nueva validación. La respuesta es ETag-cacheable: incluye la cabecera ETag derivada de la firma del snapshot. Un segundo request con If-None-Match igual al ETag recibido retorna 304 sin cuerpo, evitando la transferencia cuando el catálogo no cambió. El snapshot se renueva semanalmente. El code devuelto aquí es el que va en bank_code al crear un beneficiario tipo phone con POST /v1/beneficiaries (donde es obligatorio). Para CLABE/tarjeta el banco se infiere del prefijo/BIN, así que GET /v1/public/banks no es necesario en esos flujos.

Parámetros
Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`If-None-Match`	header	`string`	opcional	Weak ETag previamente recibido. Si el `etag_version` y `status` del row siguen iguales, el server responde 304 Not Modified sin cuerpo — útil para evitar transferir el body cuando el estado async no cambió desde el último poll.

Petición

cURLPython•JavaScript•PHP•

curl -X GET 'https://api.veriko.mx/v1/public/banks' \
  -H 'Authorization: Bearer mxcep_••••'

Ejemplo en Python — próximamente.

Ejemplo en JavaScript — próximamente.

Ejemplo en PHP — próximamente.

**Respuesta 200** `ListBanksResponse` — Catálogo SPEI completo.
Campo	Tipo	Descripción
`type` *	`string`	Tipo del recurso JSON:API.
`id` *	`string`	Código Banxico SPEI del banco (5 dígitos).
`attributes` *	`object`	Atributos canónicos del banco participante (código y nombre oficial).
`code` *	`string`	Código Banxico SPEI (mismo valor que `id`).
`name` *	`string`	Nombre del banco.
`aliases`	`array`	Nombres alternativos (marca/abreviaturas) que el normalizador de OCR mapea a este banco. Lista vacía si no hay alias curado. Minúsculas y sin acentos.

**Códigos de respuesta** `GET /v1/public/banks`
Código	Clase	Descripción	Cuerpo
200	`2xx`	Catálogo SPEI completo.	`ListBanksResponse`
304	`3xx`	No modificado — el snapshot no cambió desde 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 SHA-1 del snapshot actual. Pasar como `If-None-Match` en peticiones posteriores.