GET /v1/banks

Devuelve el listado completo de bancos venezolanos vigentes con su código SUDEBAN de 4 dígitos, nombre comercial y tipo (público o privado). Útil para poblar selects, validar transferencias o mostrar referencias bancarias.

Disponible desde el plan Starter. El plan Free no tiene acceso a las utilities venezolanas.

Request

GET /v1/banks HTTP/1.1
Host: api.cotizave.com
X-API-Key: ctz_live_aB3cD8fG2hJ5kL9mN1pQ4rS7tU0vWxYzA6bC3d

Query parameters

Parámetro	Tipo	Requerido	Descripción
`q`	string	No	Filtra por nombre del banco (case-insensitive). Si se omite, devuelve todos.

cURL

# Todos los bancos
curl https://api.cotizave.com/v1/banks \
  -H "X-API-Key: ctz_live_aB3cD8fG2hJ5kL9mN1pQ4rS7tU0vWxYzA6bC3d"

# Filtrar por nombre
curl "https://api.cotizave.com/v1/banks?q=banesco" \
  -H "X-API-Key: ctz_live_aB3cD8fG2hJ5kL9mN1pQ4rS7tU0vWxYzA6bC3d"

Response

200 OK

{
  "banks": [
    { "code": "0102", "name": "Banco de Venezuela", "type": "public" },
    { "code": "0105", "name": "Mercantil", "type": "private" },
    { "code": "0108", "name": "BBVA Provincial", "type": "private" },
    { "code": "0134", "name": "Banesco", "type": "private" }
  ],
  "total": 29
}

Schema

Campo	Tipo	Descripción
`banks[].code`	string	Código SUDEBAN de 4 dígitos.
`banks[].name`	string	Nombre comercial del banco.
`banks[].type`	string	`public` o `private`.
`total`	integer	Cantidad total de bancos en la respuesta.

Errores posibles

HTTP	code	Causa
`401`	`unauthorized`	API Key inválida, faltante o revocada.
`429`	`rate_limit_exceeded`	Cuota mensual agotada o ráfaga excedida.

Atribución

Las respuestas incluyen el header X-Data-Source: normadata.io. Catálogo mantenido en colaboración con normadata.io, referencia abierta de identificadores fiscales y bancarios LATAM.

Siguiente →Banco por código