> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cotizave.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Catálogo de bancos

> Referencia de la utilidad bancaria venezolana, sujeta a habilitación del servicio.

<Warning>Esta utilidad depende de su habilitación en el servicio y no se presenta como disponible de forma general. Si está deshabilitada responde `403 endpoint_disabled`. Esta página conserva la referencia para integraciones existentes.</Warning>

<span id="request" />

## Consulta

Requiere `X-API-Key`. El parámetro opcional `q` filtra por nombre sin distinguir mayúsculas. No es una lista de tasas bancarias.

Los ejemplos se ejecutan en el servidor. JavaScript y Python usan los clientes del [inicio rápido](/api/quickstart#paso-2); configura allí `COTIZAVE_API_KEY`.

<CodeGroup>
  ```bash curl theme={null}
  curl --fail-with-body --max-time 10 "https://api.cotizave.com/v1/banks?q=Banesco" \
    -H "X-API-Key: $COTIZAVE_API_KEY"
  ```

  ```javascript Node.js theme={null}
  import { cotizave } from './cotizave.mjs';

  const data = await cotizave('/v1/banks?q=Banesco');
  console.log(data);
  ```

  ```python Python theme={null}
  from cotizave import cotizave

  data = cotizave('/v1/banks?q=Banesco')
  print(data)
  ```
</CodeGroup>

<span id="response" />

## Respuesta cuando está habilitada

Respuesta ilustrativa: las cifras y fechas no son cotizaciones actuales.

```json theme={null}
{
  "banks": [
    {
      "code": "0134",
      "name": "Banesco",
      "type": "private"
    }
  ],
  "total": 1
}
```

`code` es texto, `name` es el nombre y `type` vale `public` o `private`. En el listado, `total` cuenta los elementos devueltos después del filtro.

<span id="errores" />

## Errores

`403 endpoint_disabled` si la utilidad está cerrada. La consulta por código devuelve `400 invalid_format` si la longitud no es cuatro y `404 bank_not_found` si no existe una entrada.

Además pueden producirse los [errores comunes](/api/errors) de autenticación, cuota o disponibilidad. Las respuestas de error de la API son JSON; decide por `code`, no por el texto de `message`.

<span id="atribucion" />

## Atribución

El catálogo procede de las utilidades compartidas con normadata.io. Las respuestas del handler incluyen `X-Data-Source: normadata.io`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.