Estado de la conexión con tu cuenta BDV

GET/bancos/bdv/credencialProbar

ServidorURL base

API key x-api-keyRecordar la clave en este navegador (localStorage, no sale de aquí)

La llamada la hace tu navegador, contra el servidor que elijas arriba. Si la documentación no está servida desde el mismo origen que la API, el navegador puede bloquear la respuesta por CORS: en ese caso abre estas páginas desde la propia API (/docs) o usa el curl de arriba.

GET

/bancos/bdv/credencial

const url = 'http://localhost:3000/v1/bancos/bdv/credencial';
const options = {method: 'GET', headers: {'x-api-key': '<x-api-key>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url http://localhost:3000/v1/bancos/bdv/credencial \
  --header 'x-api-key: <x-api-key>'

Scope bdv:read. La llave del banco nunca se devuelve: sólo sus últimos 4 caracteres. La cuenta y el teléfono salen enmascarados.

moverDinero y limiteDiario dicen si la cuenta puede dar vuelto y hasta cuánto al día. Registrar, configurar o revocar la llave se hace desde el panel.

Authorizations

ApiKeyAuth

Responses

200

La conexión vigente

application/json

object

string format: uuid

banco

string

rif

string

cuenta

Enmascarada: 0102…6479

string

telefono

Enmascarado: 0414…944

string

llave

Sólo los últimos 4: ••••BCD5

string

moverDinero

boolean

limiteDiario

Bs con punto decimal

string

estado

string

Allowed values: activa invalida

ambiente

string

Allowed values: produccion calidad

validadaEn

string format: date-time

nullable

creadaEn

string format: date-time

Example

{
  "id": "6a0b1c2d-3e4f-4a5b-8c6d-7e8f9a0b1c2d",
  "banco": "0102",
  "rif": "J000000001",
  "cuenta": "0102…0000",
  "telefono": "0414…000",
  "llave": "••••ABCD",
  "moverDinero": false,
  "limiteDiario": "0.00",
  "estado": "activa",
  "ambiente": "produccion",
  "validadaEn": "2026-10-01T14:03:00.000Z",
  "creadaEn": "2026-10-01T14:03:00.000Z"
}

404

bank_credential_missing: no has registrado la llave de tu cuenta BDV

application/json

object

error

object

meta

Contexto estructurado del error cuando lo hay: qué límite se superó y de cuánto, qué campo es inválido, cuánto saldo había. No aparece en errores internos.

object

key

additional properties

any

type

string

Allowed values: invalid_request_error authentication_error rate_limit_error upstream_error api_error

code

Código ESTABLE. Programa contra esto.

string

message

string

request_id

string

Example

{
  "error": {
    "type": "invalid_request_error",
    "code": "insufficient_balance",
    "request_id": "req_8a0312ba896772bc441134cd"
  }
}