POST /v1/bank-account/validate

Valida una cuenta bancaria venezolana de 20 dígitos y resuelve el banco emisor a partir del código SUDEBAN (primeros 4 dígitos). Útil para validar transferencias antes de enviarlas a procesar.

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

Request

POST /v1/bank-account/validate HTTP/1.1
Host: api.cotizave.com
X-API-Key: ctz_live_aB3cD8fG2hJ5kL9mN1pQ4rS7tU0vWxYzA6bC3d
Content-Type: application/json

{ "account": "0134-0000-0000-0000-0001" }

Body

Campo	Tipo	Descripción
`account`	string (requerido)	Cuenta bancaria de 20 dígitos. Acepta con o sin separadores (`0134-0000-...`, `01340000...`).

cURL

curl -X POST https://api.cotizave.com/v1/bank-account/validate \
  -H "X-API-Key: ctz_live_aB3cD8fG2hJ5kL9mN1pQ4rS7tU0vWxYzA6bC3d" \
  -H "Content-Type: application/json" \
  -d '{"account":"0134-0000-0000-0000-0001"}'

Response

200 OK

{
  "valid": true,
  "normalized": "01340000000000000001",
  "formatted": "0134-0000-0000-0000-0001",
  "bank_code": "0134",
  "bank_name": "Banesco"
}

Schema

Campo	Tipo	Descripción
`valid`	boolean	`true` si la estructura es válida (20 dígitos numéricos).
`normalized`	string	20 dígitos sin separadores (formato canónico).
`formatted`	string	Con guiones cada 4 dígitos, listo para mostrar.
`bank_code`	string	Primeros 4 dígitos = código SUDEBAN del banco emisor.
`bank_name`	string	Nombre del banco si el código existe; `Unknown` si no.

Errores posibles

HTTP	code	Causa
`400`	`missing_field`	El campo `account` es obligatorio.
`400`	`invalid_format`	No tiene 20 dígitos o contiene caracteres no numéricos.
`401`	`unauthorized`	API Key inválida, faltante o revocada.
`429`	`rate_limit_exceeded`	Cuota mensual agotada o ráfaga excedida.

Atribución

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

← AnteriorValidar RIF Siguiente →Feriados del año