{"openapi":"3.1.0","info":{"title":"Brazil Statistics API","version":"1.0.0","description":"Official Brazilian economic statistics straight from IBGE (Instituto Brasileiro de Geografia e Estatística) and its SIDRA service — no key, read live. The ipca endpoint returns the IPCA, Brazil's official consumer price index, for the latest month: the headline index (base December 1993 = 100), the month-on-month change, the year-to-date change and the all-important twelve-month inflation rate that the Banco Central targets. The ipca/series endpoint returns the historical monthly IPCA index, monthly change and twelve-month rate over the last N months, ready to chart. The aggregate endpoint is a thin live gateway to any SIDRA aggregate: pass an aggregate id, one or more variable ids, a period selector and a territorial level and it returns the parsed series — opening up thousands of IBGE tables (population, GDP, employment, industry, retail) beyond inflation. The regions endpoint lists Brazil's 27 federative units with their region grouping. Live data from IBGE SIDRA, lightly cached; decimal values parsed to numbers. Live. 5 endpoints. This serves Brazilian national statistics; for the BRL exchange rate or policy rate use a central-bank / FX API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/brazil-stats-api","description":"oanor gateway"}],"tags":[{"name":"Inflation"},{"name":"SIDRA"},{"name":"Reference"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/ipca":{"get":{"operationId":"get_v1_ipca","tags":["Inflation"],"summary":"Brazil IPCA (latest month): index, MoM, YTD and 12-month inflation","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"index":7640.15,"period":"202605","source":"IBGE (Instituto Brasileiro de Geografia e Estatística) — SIDRA aggregate 1737","country":"Brazil","indicator":"IPCA — Índice Nacional de Preços ao Consumidor Amplo (official consumer price index)","index_base":"December 1993 = 100","period_iso":"2026-05","change_12m_pct":4.72,"change_ytd_pct":3.2,"change_month_pct":0.58},"meta":{"timestamp":"2026-06-15T20:41:02.093Z","request_id":"235c8531-410a-4790-a6d6-f3f5383583fa"},"status":"ok","message":"Brazil IPCA retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/ipca/series":{"get":{"operationId":"get_v1_ipca_series","tags":["Inflation"],"summary":"Historical IPCA index + monthly + 12-month series","description":"","parameters":[{"name":"months","in":"query","required":false,"description":"Number of recent months (default 24, max 120)","schema":{"type":"string"},"example":"24"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":24,"series":[{"index":6941.51,"period":"202406","period_iso":"2024-06","change_12m_pct":4.23,"change_month_pct":0.21},{"index":6967.89,"period":"202407","period_iso":"2024-07","change_12m_pct":4.5,"change_month_pct":0.38},{"index":6966.5,"period":"202408","period_iso":"2024-08","change_12m_pct":4.24,"change_month_pct":-0.02},{"index":6997.15,"period":"202409","period_iso":"2024-09","change_12m_pct":4.42,"change_month_pct":0.44},{"index":7036.33,"period":"202410","period_iso":"2024-10","change_12m_pct":4.76,"change_month_pct":0.56},{"index":7063.77,"period":"202411","period_iso":"2024-11","change_12m_pct":4.87,"change_month_pct":0.39},{"index":7100.5,"period":"202412","period_iso":"2024-12","change_12m_pct":4.83,"change_month_pct":0.52},{"index":7111.86,"period":"202501","period_iso":"2025-01","change_12m_pct":4.56,"change_month_pct":0.16},{"index":7205.03,"period":"202502","period_iso":"2025-02","change_12m_pct":5.06,"change_month_pct":1.31},{"index":7245.38,"period":"202503","period_iso":"2025-03","change_12m_pct":5.48,"change_month_pct":0.56},{"index":7276.54,"period":"202504","period_iso":"2025-04","change_12m_pct":5.53,"change_month_pct":0.43},{"index":7295.46,"period":"202505","period_iso":"2025-05","change_12m_pct":5.32,"change_month_pct":0.26},{"index":7312.97,"period":"202506","period_iso":"2025-06","change_12m_pct":5.35,"change_month_pct":0.24},{"index":7331.98,"period":"202507","period_iso":"2025-07","change_12m_pct":5.23,"change_month_pct":0.26},{"index":7323.91,"period":"202508","period_iso":"2025-08","change_12m_pct":5.13,"change_month_pct":-0.11},{"index":7359.06,"period":"202509","period_iso":"2025-09","change_12m_pct":5.17,"change_month_pct":0.48},{"index":7365.68,"period":"202510","period_iso":"2025-10","change_12m_pct":4.68,"change_month_pct":0.09},{"index":7378.94,"period":"202511","period_iso":"2025-11","change_12m_pct":4.46,"change_month_pct":0.18},{"index":7403.29,"period":"202512","period_iso":"2025-12","change_12m_pct":4.26,"change_month_pct":0.33},{"index":7427.72,"period":"202601","period_iso":"2026-01","change_12m_pct":4.44,"change_month_pct":0.33},{"index":7479.71,"period":"202602","period_iso":"2026-02","change_12m_pct":3.81,"change_month_pct":0.7},{"index":7545.53,"period":"202603","period_iso":"2026-03","change_12m_pct":4.14,"change_month_pct":0.88},{"index":7596.09,"period":"202604","period_iso":"2026-04","change_12m_pct":4.39,"change_month_pct":0.67},{"index":7640.15,"period":"202605","period_iso":"2026-05","change_12m_pct":4.72,"change_month_pct":0.58}],"source":"IBGE SIDRA aggregate 1737","country":"Brazil","indicator":"IPCA monthly series","index_base":"December 1993 = 100"},"meta":{"timestamp":"2026-06-15T20:41:02.497Z","request_id":"fd2cd0cf-670a-4ffe-a1cc-65861440dde6"},"status":"ok","message":"Brazil IPCA series retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/aggregate":{"get":{"operationId":"get_v1_aggregate","tags":["SIDRA"],"summary":"Query any IBGE SIDRA aggregate","description":"","parameters":[{"name":"aggregate","in":"query","required":false,"description":"SIDRA aggregate id (default 1737 = IPCA)","schema":{"type":"string"},"example":"1737"},{"name":"variable","in":"query","required":false,"description":"Variable id(s), pipe-separated (default 63 = monthly change)","schema":{"type":"string"},"example":"63"},{"name":"periods","in":"query","required":false,"description":"Period selector: -1 (last n), 202605, or 202401-202605 (default -1)","schema":{"type":"string"},"example":"-1"},{"name":"level","in":"query","required":false,"description":"Territorial level: N1 country, N2 region, N3 state (default N1)","schema":{"type":"string"},"example":"N1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"level":"N1","source":"IBGE SIDRA","aggregate":"1737","variables":[{"name":"IPCA - Variação mensal","unit":"%","values":[{"value":0.58,"period":"202605","period_iso":"2026-05"}],"variable_id":"63"}]},"meta":{"timestamp":"2026-06-15T20:41:02.912Z","request_id":"b22e5bf5-4afc-4682-8a1b-d2bd5dc8b55a"},"status":"ok","message":"IBGE SIDRA aggregate retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/regions":{"get":{"operationId":"get_v1_regions","tags":["Reference"],"summary":"Brazil federative units (states)","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":27,"source":"IBGE localidades","states":[{"id":12,"name":"Acre","region":{"id":1,"name":"Norte","acronym":"N"},"acronym":"AC"},{"id":27,"name":"Alagoas","region":{"id":2,"name":"Nordeste","acronym":"NE"},"acronym":"AL"},{"id":16,"name":"Amapá","region":{"id":1,"name":"Norte","acronym":"N"},"acronym":"AP"},{"id":13,"name":"Amazonas","region":{"id":1,"name":"Norte","acronym":"N"},"acronym":"AM"},{"id":29,"name":"Bahia","region":{"id":2,"name":"Nordeste","acronym":"NE"},"acronym":"BA"},{"id":23,"name":"Ceará","region":{"id":2,"name":"Nordeste","acronym":"NE"},"acronym":"CE"},{"id":53,"name":"Distrito Federal","region":{"id":5,"name":"Centro-Oeste","acronym":"CO"},"acronym":"DF"},{"id":32,"name":"Espírito Santo","region":{"id":3,"name":"Sudeste","acronym":"SE"},"acronym":"ES"},{"id":52,"name":"Goiás","region":{"id":5,"name":"Centro-Oeste","acronym":"CO"},"acronym":"GO"},{"id":21,"name":"Maranhão","region":{"id":2,"name":"Nordeste","acronym":"NE"},"acronym":"MA"},{"id":51,"name":"Mato Grosso","region":{"id":5,"name":"Centro-Oeste","acronym":"CO"},"acronym":"MT"},{"id":50,"name":"Mato Grosso do Sul","region":{"id":5,"name":"Centro-Oeste","acronym":"CO"},"acronym":"MS"},{"id":31,"name":"Minas Gerais","region":{"id":3,"name":"Sudeste","acronym":"SE"},"acronym":"MG"},{"id":15,"name":"Pará","region":{"id":1,"name":"Norte","acronym":"N"},"acronym":"PA"},{"id":25,"name":"Paraíba","region":{"id":2,"name":"Nordeste","acronym":"NE"},"acronym":"PB"},{"id":41,"name":"Paraná","region":{"id":4,"name":"Sul","acronym":"S"},"acronym":"PR"},{"id":26,"name":"Pernambuco","region":{"id":2,"name":"Nordeste","acronym":"NE"},"acronym":"PE"},{"id":22,"name":"Piauí","region":{"id":2,"name":"Nordeste","acronym":"NE"},"acronym":"PI"},{"id":33,"name":"Rio de Janeiro","region":{"id":3,"name":"Sudeste","acronym":"SE"},"acronym":"RJ"},{"id":24,"name":"Rio Grande do Norte","region":{"id":2,"name":"Nordeste","acronym":"NE"},"acronym":"RN"},{"id":43,"name":"Rio Grande do Sul","region":{"id":4,"name":"Sul","acronym":"S"},"acronym":"RS"},{"id":11,"name":"Rondônia","region":{"id":1,"name":"Norte","acronym":"N"},"acronym":"RO"},{"id":14,"name":"Roraima","region":{"id":1,"name":"Norte","acronym":"N"},"acronym":"RR"},{"id":42,"name":"Santa Catarina","region":{"id":4,"name":"Sul","acronym":"S"},"acronym":"SC"},{"id":35,"name":"São Paulo","region":{"id":3,"name":"Sudeste","acronym":"SE"},"acronym":"SP"},{"id":28,"name":"Sergipe","region":{"id":2,"name":"Nordeste","acronym":"NE"},"acronym":"SE"},{"id":17,"name":"Tocantins","region":{"id":1,"name":"Norte","acronym":"N"},"acronym":"TO"}],"country":"Brazil"},"meta":{"timestamp":"2026-06-15T20:41:03.215Z","request_id":"33723b78-555b-46ce-b8ed-4fa2a4641eec"},"status":"ok","message":"Brazil regions retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"API metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"api":"Statistics of Brazil (IBGE) API","notes":"Live data from IBGE's SIDRA service. The aggregate endpoint can query any SIDRA aggregate/variable for any territorial level.","source":"IBGE — Instituto Brasileiro de Geografia e Estatística, SIDRA REST API (servicodados.ibge.gov.br)","country":"Brazil","endpoints":["/v1/ipca","/v1/ipca/series","/v1/aggregate","/v1/regions","/v1/meta"],"documentation":"https://brazil-stats-api.oanor.dev","primary_indicator":"IPCA — official consumer price index (SIDRA aggregate 1737, monthly, base Dec 1993=100)"},"meta":{"timestamp":"2026-06-15T20:41:03.300Z","request_id":"34e459c6-351b-4457-baa2-0030112afbfd"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":240,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1080,"monthly_call_quota":20500,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2880,"monthly_call_quota":102000,"rps_limit":22,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6480,"monthly_call_quota":455000,"rps_limit":55,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/brazil-stats-api"}