# Listar Países disponíveis
URL: /docs/inflacao/available.mdx

Endpoints para acessar dados históricos de Índices de Inflação. Permite consultar a inflação de diferentes países ao longo do tempo e listar os países com dados disponíveis.

***

title: Listar Países disponíveis
description: >-
Endpoints para acessar dados históricos de Índices de Inflação. Permite
consultar a inflação de diferentes países ao longo do tempo e listar os países
com dados disponíveis.
full: true
keywords: brapi, api, documentação, inflação
openGraph:
title: Inflação
description: >-
Endpoints para acessar dados históricos de Índices de Inflação. Permite
consultar a inflação de diferentes países ao longo do tempo e listar os
países com dados disponíveis.
type: website
locale: pt\_BR
lastUpdated: '2025-04-28T01:22:35.255Z'
lang: pt-BR
\_openapi:
method: GET
route: /api/v2/inflation/available
toc:

* depth: 2
  title: Listar Países com Dados de Inflação Disponíveis
  url: '#listar-países-com-dados-de-inflação-disponíveis'
  structuredData:
  headings:
  * content: Listar Países com Dados de Inflação Disponíveis
    id: listar-países-com-dados-de-inflação-disponíveis
    contents:
  * content: >-
    Obtenha a lista completa de todos os países para os quais a API Brapi
    possui dados de inflação disponíveis para consulta no endpoint
    `/api/v2/inflation`.

    ### Funcionalidade:

    * Retorna um array `countries` com os nomes dos países (em
      minúsculas).

    * Pode ser filtrado usando o parâmetro `search`.

    ### Autenticação:

    Requer token de autenticação via `token` (query) ou `Authorization`
    (header).

    ### Exemplo de Requisição:

    **Listar todos os países com dados de inflação:**

    ```bash

    curl -X GET
    "https://brapi.dev/api/v2/inflation/available?token=SEU_TOKEN"

    ```

    **Buscar países cujo nome contenha 'arg':**

    ```bash

    curl -X GET
    "https://brapi.dev/api/v2/inflation/available?search=arg&token=SEU_TOKEN"

    ```

    ### Resposta:

    A resposta é um objeto JSON com a chave `countries`, contendo um array
    de strings com os nomes dos países (ex: `["brazil", "argentina",
      "usa"]`).
    heading: listar-países-com-dados-de-inflação-disponíveis

***

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Endpoints para acessar dados históricos de **Índices de Inflação**.

Permite consultar a inflação de diferentes países ao longo do tempo e listar os
países com dados disponíveis.





## Swagger Documentation

# Brapi - API do Mercado Financeiro Brasileiro - /api/v2/inflation/available

Single endpoint documentation for /api/v2/inflation/available

## Base URLs

- `https://brapi.dev` - Servidor principal da API Brapi
- `http://localhost:3000` - Servidor local para desenvolvimento

## GET /api/v2/inflation/available

**Summary:** Listar Países com Dados de Inflação Disponíveis

Obtenha a lista completa de todos os países para os quais a API Brapi possui dados de inflação disponíveis para consulta no endpoint `/api/v2/inflation`.

### Funcionalidade:

*   Retorna um array `countries` com os nomes dos países (em minúsculas).
*   Pode ser filtrado usando o parâmetro `search`.

### Autenticação:

Requer token de autenticação via `token` (query) ou `Authorization` (header).

### Exemplo de Requisição:

**Listar todos os países com dados de inflação:**

```bash
curl -X GET "https://brapi.dev/api/v2/inflation/available?token=SEU_TOKEN"
```

**Buscar países cujo nome contenha 'arg':**

```bash
curl -X GET "https://brapi.dev/api/v2/inflation/available?search=arg&token=SEU_TOKEN"
```

### Resposta:

A resposta é um objeto JSON com a chave `countries`, contendo um array de strings com os nomes dos países (ex: `["brazil", "argentina", "usa"]`).

**Tags:** Inflação

### Parameters

- **search** (query): **Opcional.** Termo para filtrar a lista pelo nome do país (correspondência parcial, case-insensitive). Se omitido, retorna todos os países.
- **undefined** (undefined)

### Responses

#### 200

**Sucesso.** Retorna a lista de países disponíveis, possivelmente filtrada.

**Example Response:**

```json
{
  "countries": [
    "brazil"
  ]
}
```

#### 401

#### 404

**Not Found.** Nenhum país encontrado correspondendo ao critério de busca (`search`) informado.

**Example Response:**

```json
{
  "message": "Country not found"
}
```

## Schemas

The following schemas are used by this endpoint:

### InflationAvailableResponse

Resposta do endpoint que lista os países com dados de inflação disponíveis.

**Properties:**

- **countries** (array)
  Lista de nomes de países (em minúsculas) para os quais há dados de inflação disponíveis (ex: `brazil`, `usa`, `argentina`).
  Array items:
    **Type:** string



