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

# Lista de Países

> Serviço para obter lista de países com códigos para uso na API.

## Endpoint

```
POST https://api.tiny.com.br/api2/tabelas.paises.php
```

## Parâmetros

| Parâmetro | Tipo   | Ocorrência  | Descrição                                 |
| --------- | ------ | ----------- | ----------------------------------------- |
| token     | string | obrigatório | Chave gerada para identificar sua empresa |
| formato   | string | obrigatório | Formato do retorno (json)                 |

## Descrição

Retorna lista completa de países com códigos utilizados pela Receita Federal para preenchimento de documentos fiscais.

## Exemplo de chamada

```bash theme={null}
curl -X POST https://api.tiny.com.br/api2/tabelas.paises.php \
  -d "token=SEU_TOKEN&formato=json"
```

## Retorno

```json theme={null}
{
  "retorno": {
    "status": "OK",
    "paises": [
      {"codigo": "1058", "nome": "BRASIL"},
      {"codigo": "2496", "nome": "ESTADOS UNIDOS"},
      {"codigo": "2755", "nome": "FRANCA"}
    ]
  }
}
```

> Nota: A API retorna a lista completa com 245 países e territórios. O exemplo acima mostra apenas 3 registros para fins de demonstração.