<!-- https://pricto.dev/docs/api/list-countries · versión en inglés: https://pricto.dev/docs/api/list-countries.en.md -->

# Países, monedas e idiomas

`GET https://pricto.dev/v1/countries`

Countries, currencies and languages

| Créditos | MCP |
|---|---|
| 0 | — |

## Parámetros

| Parámetro | En | Tipo | Descripción |
|---|---|---|---|
| `lang` | query | `string` | Response language as a BCP 47 tag (`es`, `es-CL`, `en`, `en-US`...). Supported today: es, en. An unsupported language falls back to English with a warning, never an error. Falls back to `Accept-Language`, then to the account default. The resolved value is in `meta.lang`. |

## Respuesta

`200` Countries.

| Campo | Tipo | Descripción |
|---|---|---|
| `data` **requerido** | `Country[]` |  |
| `data[].code` **requerido** | `string` |  |
| `data[].name` **requerido** | `string` |  |
| `data[].currency` **requerido** | `string` |  |
| `data[].currency_minor_unit` | `integer` |  |
| `data[].languages` **requerido** | `string[]` |  |
| `data[].timezones` | `string[]` |  |
| `data[].fx_source` | `string \| null` | Official source used for local currency to USD. |
| `data[].admin_area_scheme` | `string \| null` |  |
| `data[].standard_vat_rate` | `number \| null` | Informative only. |
| `data[].status` **requerido** | `string` | Valores / values: `live`, `beta`, `planned`. |
| `meta` **requerido** | `Meta` |  |

`meta` trae el costo, la fuente para citar, el idioma, la moneda y los avisos (ver [Convenciones](/docs/convenciones)).

## Errores

## Ejemplo

```bash
curl "https://pricto.dev/v1/countries" \
  -H "Authorization: Bearer sk_test_sandbox"
```
```python
import requests

API_KEY = "sk_test_sandbox"

r = requests.get(
    "https://pricto.dev/v1/countries",
    headers={"Authorization": f"Bearer {API_KEY}"},
)
print(r.status_code, r.json())
```
```js
const API_KEY = "sk_test_sandbox";

const res = await fetch("https://pricto.dev/v1/countries", {
  headers: { Authorization: `Bearer ${API_KEY}` },
});
console.log(res.status, await res.json());
```

```json
{
  "data": [
    {
      "code": "CL",
      "currency": "CLP",
      "currency_minor_unit": 0,
      "languages": [
        "es"
      ],
      "timezones": [
        "America/Santiago",
        "Pacific/Easter"
      ],
      "fx_source": "bcch-dolar-observado",
      "admin_area_scheme": "cl-cut-comuna",
      "standard_vat_rate": 0.19,
      "status": "live",
      "name": "Chile"
    },
    {
      "code": "PE",
      "currency": "PEN",
      "currency_minor_unit": 2,
      "languages": [
        "es"
      ],
      "timezones": [
        "America/Lima"
      ],
      "fx_source": "bcrp-interbancario",
      "admin_area_scheme": "pe-ubigeo",
      "standard_vat_rate": 0.18,
      "status": "planned",
      "name": "Perú"
    },
    "… 2 más / more"
  ],
  "meta": {
    "request_id": "req_e20cc0791cbe4efd89ae",
    "attribution": {
      "text": "Fuente: Pricto · 23-10-2026 08:00 CLST",
      "source": "Pricto",
      "as_of": "2026-10-23T11:00:00Z",
      "resource_id": null,
      "url": null,
      "capture_method": null,
      "source_url": null
    },
    "credits_charged": 0,
    "credits_deduplicated": 0,
    "credits_remaining": 14988,
    "period_resets_at": "2026-11-01T00:00:00.000Z",
    "usage": {
      "credits_charged": 0,
      "credits_deduplicated": 0,
      "truncated": false,
      "truncated_reason": null,
      "dry_run": false,
      "units": {}
    },
    "lang": "es",
    "currency": "local",
    "data_as_of": "2026-10-23T11:00:00Z",
    "warnings": [
      "synthetic_data: datos sintéticos de ejemplo / synthetic sample data"
    ]
  }
}
```