Consultá las entidades bancarias disponibles y sus códigos de referencia BCRA.

Antes de empezar

1. Usá este endpoint cuando necesites poblar listas de bancos o validar un código de entidad bancaria.
2. Si querés obtener una entidad puntual, enviá bank_entity_id como query parameter.
3. Guardá el código de cada entidad para usarlo luego en requests que requieran un identificador bancario.

Cómo consultar entidades bancarias

GET /api/master-tables/bank-entities

Filtrar una entidad bancaria puntual

GET /api/master-tables/bank-entities?bank_entity_id=00011

Query parameters

Qué devuelve este endpoint

La respuesta devuelve un arreglo items. Cada elemento representa una entidad bancaria disponible.

Respuesta esperada

{
  "items": [
    {
      "bank_entity_id": "00158",
      "bank_entity": "OPEN BANK ARGENTINA S.A"
    },
    {
      "bank_entity_id": "00072",
      "bank_entity": "BANCO SANTANDER ARGENTINA S.A"
    },
    {
      "bank_entity_id": "00011",
      "bank_entity": "BANCO DE LA NACION ARGENTINA"
    }
  ]
}

Ejemplo de respuesta filtrada

{
  "items": [
    {
      "bank_entity_id": "00011",
      "bank_entity": "BANCO DE LA NACION ARGENTINA"
    }
  ]
}

Cuándo usar este endpoint

Este endpoint es útil cuando necesitás:

• listar entidades bancarias en un formulario
• validar un código BCRA antes de enviarlo a otro servicio
• traducir un identificador técnico a un nombre de banco legible

Errores frecuentes

• 404 Value not found: el código enviado no tiene coincidencias en el maestro.
• 422 Validation Error: el query parameter tiene un formato inválido.

Siguiente paso

Si necesitás consultar tipos de cuenta bancaria, usá GET /api/master-tables/bank-account-types.