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

# Listar países

> Obtén la lista completa de países que admite VelaFi. Filtra por estado de validez para devolver solo los países activos o incluir todos los registros.

Usa el endpoint **GET** `/v2/base/countrys` para obtener todos los países que VelaFi admite en sus servicios de on-ramp, off-ramp y pagos globales. De forma predeterminada, la respuesta incluye solo los países activos (válidos); envía `hasFindAll=true` para obtener la lista completa, incluidos los inactivos. Usa los códigos ISO 3166-1 devueltos al construir las solicitudes posteriores que requieran un parámetro `country`.

## Solicitud

```text theme={null}
GET /v2/base/countrys
```

### Headers

| Header | Valor | Obligatorio |
| - | - | - |
| `X-BH-TOKEN` | Tu token de `GET /v2/token/generate` | ✓ |

### Parámetros de consulta

**hasFindAll** `boolean`

Cuando es `true`, devuelve todos los países, incluidos los inactivos. El valor predeterminado es `false`, que devuelve solo los países válidos (activos).

## Campos de la respuesta

**code** `number`

Código de estado de tipo HTTP. `200` indica éxito.

**msg** `string`

Mensaje de estado legible, por ejemplo `"SUCCESS"`.

**data** `array`

Arreglo de objetos de país.

**data\[]**

**country** `string`

Nombre completo del país (por ejemplo, `"Mexico"`).

**abbr** `string`

Código de país ISO 3166-1 alfa-2 (por ejemplo, `"MX"`).

## Ejemplos

```bash cURL — valid countries only theme={null}
curl --request GET \
  --url 'https://api.velafi.com/v2/base/countrys' \
  --header 'X-BH-TOKEN: YOUR_TOKEN'
```

```bash cURL — all countries theme={null}
curl --request GET \
  --url 'https://api.velafi.com/v2/base/countrys?hasFindAll=true' \
  --header 'X-BH-TOKEN: YOUR_TOKEN'
```

### Respuesta

```json theme={null}
{
  "code": 200,
  "msg": "SUCCESS",
  "data": [
    {
      "country": "Mexico",
      "abbr": "MX"
    },
    {
      "country": "Argentina",
      "abbr": "AR"
    },
    {
      "country": "Brazil",
      "abbr": "BR"
    }
  ]
}
```

> [!NOTE]
>
> El campo `abbr` devuelve el código ISO 3166-1 alfa-2 de cada país. Usa este valor en cualquier solicitud a la API que espere una abreviatura de `country`.


## Related topics

- [Listar comercios](https://docs.velafi.com/es/api-reference/merchant/get-a-list-of-merchants.md)
- [Listar webhooks](https://docs.velafi.com/es/api-reference/webhooks/get-webhook-endpoints.md)
- [Listar criptomonedas](https://docs.velafi.com/es/api-reference/basic-configuration/get-list-of-crypto-currencies.md)
- [Listar órdenes](https://docs.velafi.com/es/api-reference/order/retrieve-a-list-of-orders.md)
- [Listar beneficiarios](https://docs.velafi.com/es/api-reference/beneficiary/get-beneficiary.md)


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