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

# Listar instituciones

> Los bancos que se pueden conectar con Tupana Link y qué entrega cada uno.

Los bancos que una empresa puede conectar con
[Tupana Link](https://docs.tupana.ai/api-reference/v2/connect/tupana-link.md) y qué entrega cada uno. Es
el mismo catálogo que ve el usuario final en el widget.

```bash theme={null}
curl https://api.tupana.ai/v2/institutions/ \
  -H "Authorization: Api-Key TU_API_KEY"
```

```json theme={null}
{
  "data": [
    {
      "code": "cl_banco_santander",
      "name": "Banco Santander",
      "source": "fintoc",
      "status": "available",
      "capabilities": {
        "balances": true,
        "movements": true,
        "cards": false,
        "payments": false
      }
    }
  ]
}
```

## Qué dice cada campo

* `code` identifica al banco en toda la API: es el que verás en las conexiones y,
  más adelante, en cada cuenta y movimiento.
* `source` es por dónde lee Tupana ese banco: `fintoc` (proveedor de bancos) o
  `scraper` (conector propio). No cambia lo que recibes.
* `status` es `available` cuando el banco entrega datos, y `coming_soon` cuando
  Tupana todavía solo guarda la credencial para integrarlo después.
* `capabilities` dice qué se lee: `balances` y `movements` hoy; `cards` y
  `payments` vienen en falso hasta que existan, para que tu integración ya
  tenga el contrato.

> [!NOTE]
>
> El banco de pruebas de sandbox no aparece acá: con una API key de sandbox las
> conexiones se fabrican sin elegir banco.


## OpenAPI

````yaml api-reference/openapi-v2.json GET /institutions/
openapi: 3.0.0
info:
  title: Tupana API — v2
  description: >-
    API v2 de Tupana: facturación electrónica, cesiones, recaudación, consultas,
    boleta de honorarios y nómina. Los identificadores de recursos son public
    IDs opacos con prefijo (docu_, ment_, cred_, doce_, empl_…).
  version: 2.0.0
servers:
  - url: https://api.tupana.ai/v2
    description: Producción (v2)
security:
  - apiKeyAuth: []
paths:
  /institutions/:
    get:
      tags:
        - Instituciones
      summary: Listar instituciones
      description: >-
        Los bancos que se pueden conectar con Tupana Link y qué entrega cada
        uno.
      operationId: listInstitutions_v2
      responses:
        '200':
          description: Catálogo de bancos
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                          example: cl_banco_santander
                          description: Identifica al banco en toda la API.
                        name:
                          type: string
                          example: Banco Santander
                        source:
                          type: string
                          enum:
                            - fintoc
                            - scraper
                          description: Por dónde lee Tupana este banco.
                        status:
                          type: string
                          enum:
                            - available
                            - coming_soon
                          description: >-
                            `coming_soon`: Tupana guarda la credencial pero
                            todavía no entrega datos.
                        capabilities:
                          type: object
                          properties:
                            balances:
                              type: boolean
                            movements:
                              type: boolean
                            cards:
                              type: boolean
                              description: Siempre falso por ahora.
                            payments:
                              type: boolean
                              description: 'Siempre falso: la API bancaria no mueve dinero.'
      security:
        - apiKeyAuth: []
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        API Key para autenticación. Debe proporcionarse en el header
        Authorization con el formato: 'Api-Key YOUR-API-KEY' (incluye el prefijo
        'Api-Key ' seguido de tu API key)

````

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