---
title: "Obter Dados de Inflação (IPCA)"
method: GET
path: "/api/v2/inflation"
tags: ["Indicadores"]
---

# Obter Dados de Inflação (IPCA)

`GET /api/v2/inflation`

Retorna dados históricos do **IPCA (Índice Nacional de Preços ao Consumidor Amplo)**, o índice oficial de inflação do Brasil, medido pelo IBGE.

### Funcionalidades

*   **Dados Mensais:** Variação percentual mensal do IPCA
*   **Histórico Completo:** Dados desde janeiro/2000 até o mês atual
*   **Filtros de Período:** Use `start` e `end` para definir período específico (formato DD/MM/YYYY)
*   **Ordenação:** Ordene por data ou valor, crescente ou decrescente

### Autenticação

Bearer token ou query param `token`. Requer plano Startup.

### Exemplos de Uso

```bash
# Padrão (últimos 12 meses)
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/inflation"

# Histórico completo
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/inflation?historical=true"

# Período específico
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/inflation?start=01/01/2023&end=31/12/2023"

# Ordenado por valor (decrescente)
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/inflation?historical=true&sortBy=value&sortOrder=desc"
```

### Parâmetros de Ordenação

*   `sortBy`: `date` (padrão) ou `value`
*   `sortOrder`: `desc` (padrão) ou `asc`

### Campos da Resposta

*   `date` — Data no formato DD/MM/YYYY
*   `value` — Variação percentual do IPCA no mês
*   `epochDate` — Data em timestamp Unix (milissegundos)

### Sobre o IPCA

O IPCA é o índice oficial de inflação do Brasil, calculado mensalmente pelo IBGE. Ele mede a variação de preços de uma cesta de produtos e serviços consumidos pelas famílias brasileiras.

### Fonte dos Dados

Banco Central do Brasil (BCB) — indicador IPCA publicado como série temporal oficial

**Plano Mínimo:** Startup | **Autenticação:** Necessária

## Query parameters

- `historical` string — Incluir dados históricos (true/false)
- `start` string — Data de início (DD/MM/YYYY)
- `end` string — Data de fim (DD/MM/YYYY)
- `sortBy` string — Campo para ordenação (date ou value)
- `sortOrder` string — Ordem de classificação (asc ou desc)

## Response `200`

Dados históricos de inflação (IPCA) retornados com sucesso conforme os filtros aplicados. Array contém variações percentuais mensais ordenadas conforme solicitado.

- InflationResponseSimple
  - `inflation` InflationEntrySimple[], required
    - `date` string, required
    - `value` string, required — Variação percentual do IPCA no mês
    - `epochDate` number, required
  - `requestedAt` string, date-time, required — Data e hora da requisição em formato ISO 8601
  - `took` integer, required — Tempo de processamento em milissegundos

## Other responses

- `401` — **Não Autorizado.** Token de autenticação não fornecido ou inválido.
- `403` — **Acesso Proibido.** Seu plano não tem acesso ao módulo de indicadores econômicos.
- `500` — **Erro Interno.** Erro interno ao processar a requisição.
- `503` — **Serviço Indisponível.** Serviço externo temporariamente indisponível.

---

[API](https://skmtc.net/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) · [All operations](https://skmtc.net/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brapi-dev/brapi-api-do-mercado-financeiro-brasileiro/revisions/f275d46193ea/schema)