GET /v1/banks/:code

Lookup de un banco venezolano por su código SUDEBAN de 4 dígitos. Útil cuando ya tenés un código (ej: extraído de una cuenta bancaria de 20 dígitos) y necesitás resolverlo a nombre.

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

Request

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

Path parameters

Parámetro	Tipo	Descripción
`code`	string	Código SUDEBAN de exactamente 4 dígitos (ej: `0102`, `0134`).

cURL

curl https://api.cotizave.com/v1/banks/0134 \
  -H "X-API-Key: ctz_live_aB3cD8fG2hJ5kL9mN1pQ4rS7tU0vWxYzA6bC3d"

Response

200 OK

{
  "code": "0134",
  "name": "Banesco",
  "type": "private"
}

Errores posibles

HTTP	code	Causa
`400`	`invalid_format`	El código no tiene exactamente 4 dígitos.
`401`	`unauthorized`	API Key inválida, faltante o revocada.
`404`	`bank_not_found`	No existe un banco activo con ese código.
`429`	`rate_limit_exceeded`	Cuota mensual agotada o ráfaga excedida.

Atribución

Header X-Data-Source: normadata.io. Catálogo mantenido junto a normadata.io.

← AnteriorListado de bancos Siguiente →Validar RIF