# Consultar entidades bancarias

Obtén las entidades bancarias habilitadas para realizar dispersiones. Es importante tener el cuenta la moneda y el tipo de proceso que vas a realizar.

## Ruta

<mark style="color:blue;">`GET`</mark> `/v1/merchant/payout/entities`

## **Encabezado**

<table><thead><tr><th width="244">Name</th><th width="138">Type</th><th>Description</th></tr></thead><tbody><tr><td>x-auth-token<mark style="color:red;">*</mark></td><td>String</td><td>Es el código generado a partir del proceso de autenticación.</td></tr><tr><td>Content-Type</td><td>String</td><td><p>Es el tipo de contenido que se está enviando en la solicitud.</p><p><em><code>Ejemplo: application/json</code></em></p></td></tr></tbody></table>

## **Cuerpo**

<table><thead><tr><th width="223">Name</th><th width="154">Type<select><option value="8B5k2YmvoPQH" label="string" color="blue"></option></select></th><th>Description</th></tr></thead><tbody><tr><td><code>type</code></td><td><span data-option="8B5k2YmvoPQH">string</span></td><td><p>Es el método que se usará para la dispersión.<br></p><p><mark style="color:green;"><code>normal | instant | scheduled</code></mark><br><br><em>Por defecto es <code>normal</code></em></p></td></tr><tr><td><code>currency</code></td><td><span data-option="8B5k2YmvoPQH">string</span></td><td><p>Código que identifica la divisa de la dispersión en formato ISO 4217.<br></p><p><mark style="color:green;"><code>COP | USD</code></mark><br><em>Por defecto es <code>COP</code></em></p></td></tr></tbody></table>

## **Respuesta**

{% tabs %}
{% tab title="200" %}

```json
{
    "entities": [
        {
            "code": 1815,
            "name": "Alianza Fiduciaria",
            "account_number": {
                "min_length": 6,
                "max_length": 16
            },
            "logos": {
                "default": "https://content.trazo.co/payments/logos/1815.png",
                "circle": "https://content.trazo.co/payments/logos/1815-circle.png",
                "horizontal": "https://content.trazo.co/payments/logos/1815-horizontal.png"
            }
        },
        {...}
    ]
}
```

{% endtab %}

{% tab title="400" %}

```json
{
    "error": "No bank was found with the provided parameters. Please try again with a different type (type)."
}
```

{% endtab %}
{% endtabs %}

***

## Ejemplo

{% tabs %}
{% tab title="cURL" %}

```bash
curl --location --request GET '{{base_url}}/v1/merchant/payout/entities' \
--header 'x-auth-token: {{token}}' \
--data '{
    "currency": "USD"
}'
```

{% endtab %}

{% tab title="NodeJS(Axios)" %}

```javascript
const axios = require('axios');

let data = JSON.stringify({
  "currency": "COP",
  "type": "instant"
});


let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: `${base_url}/v1/merchant/payout/entities`,
  headers: { 
    'x-auth-token': token //Añadir token
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

```

{% endtab %}

{% tab title="Python" %}

```python
import requests

url = f"{base_url}/v1/merchant/payout/entities"

payload = json.dumps({
  "currency": "COP",
  "type": "instant"
})

headers = {
  'x-auth-token': token #Añadir token
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

```

{% endtab %}
{% endtabs %}