# Instituciones bancarias disponibles

Fuente: /banking/bank-institutions/

Esta sección explica cómo utilizar el endpoint para obtener la lista de instituciones bancarias disponibles.

**Método:**   GET

#### **Endpoint**

```
https://api.verificamex.com/identity/v1/banking/bank-institutions

```

> **Nota**
>
> Recuerda que debes tener un token válido para realizar la solicitud.
> Puedes obtener un token siguiendo los pasos descritos en la sección [Generar tokens](/authentication/generate-tokens/).

### **Encabezados de la Solicitud**

Para realizar la solicitud es necesario incluir los siguientes encabezados:

| Encabezado | Valor | Descripción |
| - | - | - |
| Accept | `application/json` | Tipo de contenido de la solicitud. |
| Authorization | `Bearer {tu_token}` | Token generado para autenticar al usuario. |

### **Parámetros de la Solicitud**

Para paginar los resultados se debe incluir los siguientes parámetros:

| Parámetro | Tipo | Descripción |
| - | - | - |
| page | `Integer` | Número de página. |
| limit | `Integer` | Límite de instituciones bancarias por página. |

### Respuesta del Endpoint

**status 200**

```json
{
    "data": [
        {
            "object": "BankInstitution",
            "clave": "2001",
            "name": "BANXICO"
        },
        {
            "object": "BankInstitution",
            "clave": "37006",
            "name": "BANCOMEXT"
        },
        {
            "object": "BankInstitution",
            "clave": "37009",
            "name": "BANOBRAS"
        },
        {
            "object": "BankInstitution",
            "clave": "37019",
            "name": "BANJERCITO"
        },
        {
            "object": "BankInstitution",
            "clave": "37135",
            "name": "NAFIN"
        },
        {
            "object": "BankInstitution",
            "clave": "37166",
            "name": "BaBien"
        },
        {
            "object": "BankInstitution",
            "clave": "37168",
            "name": "HIPOTECARIA FED"
        },
        {
            "object": "BankInstitution",
            "clave": "40002",
            "name": "BANAMEX"
        },
        {
            "object": "BankInstitution",
            "clave": "40012",
            "name": "BBVA MEXICO"
        },
        {
            "object": "BankInstitution",
            "clave": "40014",
            "name": "SANTANDER"
        }
    ],
    "meta": {
        "include": [],
        "custom": [],
        "pagination": {
            "total": 95,
            "count": 10,
            "per_page": 10,
            "current_page": 1,
            "total_pages": 10,
            "links": {
                "next": "https://api.verificamex.com/v1/banking/bank-institutions?search=name%3ANU%20Mexico&page=2"
            }
        }
    }
}
```

**status 401**

```json
{   
    "message":"An Exception occurred while trying to authenticate the User.",
    "errors":[],
    "exception":"Apiato\\Core\\Exceptions\\AuthenticationException",
    "file":"/opt/bitnami/apache/htdocs/verificamex-api/app/Ship/Exceptions/Handlers/ExceptionsHandler.php",

    más datos.....
}
```