IBGE Statistical Table Values

Read the values of one of IBGE's statistical tables for Brazil: unemployment (table 4099), IPCA inflation (7060), municipal GDP (5938), Censo 2022 population (4709) and 9,000+ more. Choose the variables, the period (latest, one period or a range), the territorial level (country, region, state, municipality) with optional IBGE territory codes, and classification categories. Each value comes with its territory, period, unit and categories. Up to 15,000 values per call.

post/br/ibge/table-values/v1

Request

Base URL: https://api.croma.run
URL: https://api.croma.run/br/ibge/table-values/v1
Auth: HTTP bearer

Headers

Idempotency-Keystring

Example:0f8e9a42-6b7c-4d1e-9a3f-2c5d7e8f9a0b

Optional client-chosen key for this request (any string up to 255 characters, e.g. a UUID). Every Croma operation is an idempotent lookup: repeating a request with the same body returns the same result and creates nothing, so retrying after a timeout or network failure is always safe. The key is echoed back in the Idempotency-Key response header so you can correlate a retry with its first attempt. Each attempt that reaches the API counts against the rate limit.

Request body

table_idstring required

The table's number, e.g. 4099 (unemployment, PNAD Contínua). ibge-tables-search finds it.

variable_idsstring

The variables to return, by number and separated by commas, e.g. 4099 or 4099,4114. Empty returns every variable of the table (optional).

periodstring

latest (the most recent period the table has), one period (2023 for a year, 202609 for a month, 202602 for the second quarter of 2026), or a range of them, e.g. 202401-202604.

territory_level'country' | 'region' | 'state' | 'municipality'

The territorial level of the values: country (Brazil), region (the five Grandes Regiões), state (the 27 UFs) or municipality.

territory_codestring

IBGE codes of the territories, separated by commas: a region's 1 digit, a state's 2 (e.g. 35 São Paulo) or a municipality's 7 (e.g. 3550308 São Paulo). Empty returns every territory of the level (optional).

classificationsstring

Breakdowns to return, as classification:categories, several separated by ;, e.g. 315:7170,7171 (two IPCA groups) or 2:all (every category of classification 2). A classification left out returns its total (optional).

Response

Successful response

Changes

No recorded changes to this operation across all 1 revision of this API.