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 en todos los planes, incluido Free.
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.