API de localidades

API e documentação

Versão: 1.0.0

API referente aos países e às divisões político-administrativas do Brasil bem como meso e microrregiões, institucionalizadas pela aprovação da presidência do IBGE da resolução PR nº 51/1989 e pela publicação Divisão regional do Brasil em mesorregiões e microrregiões geográficas.

obs 1: exceptuando-se as rotas referentes aos países, os identificadores providos pela presente API são oficialmente designados pelo IBGE.
obs 2: as regiões geográficas imediatas e intermediárias decorrem da revisão das microrregiões e mesorregiões diante do expressivo aumento das diferenças inter-regionais, como resultado das mudanças econômicas, demográficas, políticas e ambientais ocorridas ao longo das últimas décadas. Assim, as regiões geográficas imediatas e intermediárias serão periodicamente revisadas, visando oferecer elementos para a compreensão da realidade brasileira. Adicionalmente, passam a substituir as mesorregiões e microrregiões geográficas de forma progressiva até 21/12/2023. Para maiores informações, incluindo metodologia e nomenclatura, acesse Divisão regional do Brasil em regiões geográficas imediatas e regiões geográficas intermediárias
obs 3: para fins das rotas relacionadas aos países, os países foram organizados de acordo com a metodologia M49 da Organização das Nações Unidas, segundo o qual os países são agrupados em regiões - Equivalente ao que conhecemos como continentes -, sub-regiões e regiões intermediárias, da qual o Brasil é signatário. Para maiores informações, acesse https://unstats.un.org/unsd/methodology/m49/
obs 4: Se desejar, use o Query Builder para gerar consultas customizadas.

Aglomerações urbanas por identificador

Obtém o conjunto de aglomerações urbanas a partir dos respectivos identificadores

https://servicodados.ibge.gov.br/api/v1/localidades/aglomeracoes-urbanas/{aglomeracao-urbana}

Parâmetros

Name	Description
aglomeracao-urbana*

Query parameters

Name	Description
orderBy

Responses

Status: 200 - Um array de aglomerações urbanas

Schema

Aglomerações urbanas

Obtém o conjunto de aglomerações urbanas do Brasil

https://servicodados.ibge.gov.br/api/v1/localidades/aglomeracoes-urbanas

Parâmetros

Query parameters

Name	Description
orderBy
municipio

Responses

Status: 200 - Um array de aglomerações urbanas

Schema

Distritos

Obtém o conjunto de distritos do Brasil

https://servicodados.ibge.gov.br/api/v1/localidades/distritos

Parâmetros

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de distritos

Schema

Distritos por identificador

Obtém o conjunto de distritos do Brasil a partir dos respectivos identificadores

https://servicodados.ibge.gov.br/api/v1/localidades/distritos/{id}

Parâmetros

Name	Description
id*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de distritos

Schema

Distritos por UF

Obtém o conjunto de distritos do Brasil a partir dos identificadores das Unidades da Federação

https://servicodados.ibge.gov.br/api/v1/localidades/estados/{UF}/distritos

Parâmetros

Name	Description
UF*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de distritos

Schema

Distritos por mesorregião

Obtém o conjunto de distritos do Brasil a partir dos identificadores das mesorregiões

https://servicodados.ibge.gov.br/api/v1/localidades/mesorregioes/{mesorregiao}/distritos

Parâmetros

Name	Description
mesorregiao*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de distritos

Schema

Distritos por microrregião

Obtém o conjunto de distritos do Brasil a partir dos identificadores das microrregiões

https://servicodados.ibge.gov.br/api/v1/localidades/microrregioes/{microrregiao}/distritos

Parâmetros

Name	Description
microrregiao*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de distritos

Schema

Distritos por município

Obtém o conjunto de distritos do Brasil a partir dos identificadores dos municípios

https://servicodados.ibge.gov.br/api/v1/localidades/municipios/{municipio}/distritos

Parâmetros

Name	Description
municipio*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de distritos

Schema

Distritos por região imediata

Obtém o conjunto de distritos do Brasil a partir dos identificadores das regiões imediatas

https://servicodados.ibge.gov.br/api/v1/localidades/regioes-imediatas/{regiao-imediata}/distritos

Parâmetros

Name	Description
regiao-imediata*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de distritos

Schema

Distritos por região intermediária

Obtém o conjunto de distritos do Brasil a partir dos identificadores das regiões intermediárias

https://servicodados.ibge.gov.br/api/v1/localidades/regioes-intermediarias/{regiao-intermediaria}/distritos

Parâmetros

Name	Description
regiao-intermediaria*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de distritos

Schema

Distritos por região

Obtém o conjunto de distritos do Brasil a partir dos identificadores das regiões

https://servicodados.ibge.gov.br/api/v1/localidades/regioes/{macrorregiao}/distritos

Parâmetros

Name	Description
macrorregiao*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de distritos

Schema

Mesorregiões por UF

Obtém o conjunto de mesorregiões do Brasil a partir dos identificadores das Unidades da Federação

https://servicodados.ibge.gov.br/api/v1/localidades/estados/{UF}/mesorregioes

Parâmetros

Name	Description
UF*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de mesorregiões

Schema

Mesorregiões

Obtém o conjunto de mesorregiões do Brasil

https://servicodados.ibge.gov.br/api/v1/localidades/mesorregioes

Parâmetros

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de mesorregiões

Schema

Mesorregião por identificador

Obtém o conjunto de mesorregiões do Brasil a partir dos respectivos identificadores

https://servicodados.ibge.gov.br/api/v1/localidades/mesorregioes/{mesorregiao}

Parâmetros

Name	Description
mesorregiao*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um objeto - Caso apenas um identificador seja informado - ou um array de mesorregiões

Schema

Mesorregiões por região

Obtém o conjunto de mesorregiões do Brasil a partir dos identificadores das regiões

https://servicodados.ibge.gov.br/api/v1/localidades/regioes/{macrorregiao}/mesorregioes

Parâmetros

Name	Description
macrorregiao*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de mesorregiões

Schema

Microrregiões por UF

Obtém o conjunto de microrregiões do Brasil a partir dos identificadores das Unidades da Federação

https://servicodados.ibge.gov.br/api/v1/localidades/estados/{UF}/microrregioes

Parâmetros

Name	Description
UF*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de microrregiões

Schema

Microrregiões por mesorregião

Obtém o conjunto de microrregiões do Brasil a partir dos identificadores das mesorregiões

https://servicodados.ibge.gov.br/api/v1/localidades/mesorregioes/{mesorregiao}/microrregioes

Parâmetros

Name	Description
mesorregiao*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de microrregiões

Schema

Microrregiões

Obtém o conjunto de microrregiões do Brasil

https://servicodados.ibge.gov.br/api/v1/localidades/microrregioes

Parâmetros

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de microrregiões

Schema

Microrregião por identificador

Obtém o conjunto de microrregiões do Brasil a partir dos respectivos identificadores

https://servicodados.ibge.gov.br/api/v1/localidades/microrregioes/{microrregiao}

Parâmetros

Name	Description
microrregiao*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um objeto - Caso apenas um identificador seja informado - ou um array de microrregiões

Schema

Microrregiões por região

Obtém o conjunto de microrregiões do Brasil a partir dos identificadores das regiões

https://servicodados.ibge.gov.br/api/v1/localidades/regioes/{macrorregiao}/microrregioes

Parâmetros

Name	Description
macrorregiao*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de microrregiões

Schema

Municípios por UF

Obtém o conjunto de municípios do Brasil a partir dos identificadores das Unidades da Federação

https://servicodados.ibge.gov.br/api/v1/localidades/estados/{UF}/municipios

Parâmetros

Name	Description
UF*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de municípios

Schema

Municípios por mesorregião

Obtém o conjunto de municípios do Brasil a partir dos identificadores das mesorregiões

https://servicodados.ibge.gov.br/api/v1/localidades/mesorregioes/{mesorregiao}/municipios

Parâmetros

Name	Description
mesorregiao*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de municípios

Schema

Municípios por microrregião

Obtém o conjunto de municípios do Brasil a partir dos identificadores das microrregiões

https://servicodados.ibge.gov.br/api/v1/localidades/microrregioes/{microrregiao}/municipios

Parâmetros

Name	Description
microrregiao*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de municípios

Schema

Municípios

Obtém o conjunto de municípios do Brasil

https://servicodados.ibge.gov.br/api/v1/localidades/municipios

Parâmetros

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de municípios

Schema

Município por identificador

Obtém o conjunto de municípios do Brasil a partir dos respectivos identificadores

https://servicodados.ibge.gov.br/api/v1/localidades/municipios/{municipio}

Parâmetros

Name	Description
municipio*

Query parameters

Name	Description
orderBy
view

Responses

Status: responses -

Municípios por região imediata

Obtém o conjunto de municípios do Brasil a partir dos identificadores das regiões imediatas

https://servicodados.ibge.gov.br/api/v1/localidades/regioes-imediatas/{regiao-imediata}/municipios

Parâmetros

Name	Description
regiao-imediata*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de municípios

Schema

Municípios por região intermediária

Obtém o conjunto de municípios do Brasil a partir dos identificadores das regiões intermediárias

https://servicodados.ibge.gov.br/api/v1/localidades/regioes-intermediarias/{regiao-intermediaria}/municipios

Parâmetros

Name	Description
regiao-intermediaria*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de municípios

Schema

Municípios por região

Obtém o conjunto de municípios do Brasil a partir dos identificadores das regiões

https://servicodados.ibge.gov.br/api/v1/localidades/regioes/{macrorregiao}/municipios

Parâmetros

Name	Description
macrorregiao*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de municípios

Schema

Países

Obtém o conjunto de países

https://servicodados.ibge.gov.br/api/v1/localidades/paises

Parâmetros

Query parameters

Name	Description
orderBy
view
lang

Responses

Status: 200 - Array de países

Schema

País por identificador

Obtém o conjunto de países a partir dos respectivos identificadores

https://servicodados.ibge.gov.br/api/v1/localidades/paises/{pais}

Parâmetros

Name	Description
pais*

Query parameters

Name	Description
orderBy
view
lang

Responses

Status: 200 - Um objeto - Caso apenas um identificador seja informado - ou um array de países

Schema

Regiões

Obtém o conjunto de regiões do Brasil

https://servicodados.ibge.gov.br/api/v1/localidades/regioes

Parâmetros

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Array de regiões

Schema

Região por identificador

Obtém o conjunto de regiões do Brasil a partir dos respectivos identificadores

https://servicodados.ibge.gov.br/api/v1/localidades/regioes/{macrorregiao}

Parâmetros

Name	Description
macrorregiao*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um objeto - Caso apenas um identificador seja informado - ou um array de regiões

Schema

Regiões imediatas por UF

Obtém o conjunto de regiões imediatas do Brasil a partir dos identificadores das Unidades da Federação

https://servicodados.ibge.gov.br/api/v1/localidades/estados/{UF}/regioes-imediatas

Parâmetros

Name	Description
UF*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de regiões imediatas

Schema

Regiões imediatas

Obtém o conjunto de regiões imediatas do Brasil

https://servicodados.ibge.gov.br/api/v1/localidades/regioes-imediatas

Parâmetros

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de regiões imediatas

Schema

Regiões imediatas por identificador

Obtém o conjunto de regiões imediatas do Brasil a partir dos respectivos identificadores

https://servicodados.ibge.gov.br/api/v1/localidades/regioes-imediatas/{regiao-imediata}

Parâmetros

Name	Description
regiao-imediata*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um objeto - Caso apenas um identificador seja informado - ou um array de regiões imediatas

Schema

Regiões imediatas por regiões intermediárias

Obtém o conjunto de regiões imediatas do Brasil a partir dos identificadores das regiões intermediárias

https://servicodados.ibge.gov.br/api/v1/localidades/regioes-intermediarias/{regiao-intermediaria}/regioes-imediatas

Parâmetros

Name	Description
regiao-intermediaria*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de regiões imediatas

Schema

Regiões imediatas por região

Obtém o conjunto de regiões imediatas do Brasil a partir dos identificadores das regiões

https://servicodados.ibge.gov.br/api/v1/localidades/regioes/{macrorregiao}/regioes-imediatas

Parâmetros

Name	Description
macrorregiao*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de regiões imediatas

Schema

Regiões integradas de desenvolvimento

Obtém o conjunto de regiões integradas de desenvolvimento do Brasil

https://servicodados.ibge.gov.br/api/v1/localidades/regioes-integradas-de-desenvolvimento

Parâmetros

Query parameters

Name	Description
orderBy
municipio

Responses

Status: 200 - Um array de regiões integradas de desenvolvimento

Schema

Regiões integradas de desenvolvimento por identificador

Obtém o conjunto de regiões integradas de desenvolvimento a partir dos respectivos identificadores

https://servicodados.ibge.gov.br/api/v1/localidades/regioes-integradas-de-desenvolvimento/{regiao-integrada-de-desenvolvimento}

Parâmetros

Name	Description
regiao-integrada-de-desenvolvimento*

Query parameters

Name	Description
orderBy

Responses

Status: 200 - Um array de regiões integradas de desenvolvimento

Schema

Regiões intermediárias por UF

Obtém o conjunto de regiões intermediárias do Brasil a partir dos identificadores das Unidades da Federação

https://servicodados.ibge.gov.br/api/v1/localidades/estados/{UF}/regioes-intermediarias

Parâmetros

Name	Description
UF*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de regiões intermediárias

Schema

Regiões intermediárias

Obtém o conjunto de regiões intermediárias do Brasil

https://servicodados.ibge.gov.br/api/v1/localidades/regioes-intermediarias

Parâmetros

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de regiões intermediárias

Schema

Região intermediária por identificador

Obtém o conjunto de regiões intermediárias do Brasil a partir dos respectivos identificadores

https://servicodados.ibge.gov.br/api/v1/localidades/regioes-intermediarias/{regiao-intermediaria}

Parâmetros

Name	Description
regiao-intermediaria*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um objeto - Caso apenas um identificador seja informado - ou um array de regiões intermediárias

Schema

Regioes intermediárias por região

Obtém o conjunto de regiões intermediárias do Brasil a partir dos identificadores das regiões

https://servicodados.ibge.gov.br/api/v1/localidades/regioes/{macrorregiao}/regioes-intermediarias

Parâmetros

Name	Description
macrorregiao*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de regioes intermediárias

Schema

Regiões metropolitanas por UF

Obtém o conjunto de regiões metropolitanas do Brasil a partir dos identificadores das Unidades da Federação

https://servicodados.ibge.gov.br/api/v1/localidades/estados/{UF}/regioes-metropolitanas

Parâmetros

Name	Description
UF*

Query parameters

Name	Description
orderBy

Responses

Status: 200 - Um array de regiões metropolitanas

Schema

Regiões metropolitanas por região

Obtém o conjunto de regiões metropolitanas do Brasil a partir dos identificadores das regiões

https://servicodados.ibge.gov.br/api/v1/localidades/regioes/{macrorregiao}/regioes-metropolitanas

Parâmetros

Name	Description
macrorregiao*

Query parameters

Name	Description
orderBy

Responses

Status: 200 - Um array de regiões metropolitanas

Schema

Regiões metropolitanas

Obtém o conjunto de regiões metropolitanas do Brasil

https://servicodados.ibge.gov.br/api/v1/localidades/regioes-metropolitanas

Parâmetros

Query parameters

Name	Description
orderBy
municipio

Responses

Status: 200 - Um array de regiões metropolitanas

Schema

Regiões metropolitanas por identificador

Obtém o conjunto de regiões metropolitanas a partir dos respectivos identificadores

https://servicodados.ibge.gov.br/api/v1/localidades/regioes-metropolitanas/{regiao-metropolitana}

Parâmetros

Name	Description
regiao-metropolitana*

Query parameters

Name	Description
orderBy

Responses

Status: 200 - Um array de regiões metropolitanas

Schema

Subdistritos por distrito

Obtém o conjunto de subdistritos do Brasil a partir dos identificadores dos distritos

https://servicodados.ibge.gov.br/api/v1/localidades/distritos/{distrito}/subdistritos

Parâmetros

Name	Description
distrito*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de subdistritos

Schema

Subdistritos por UF

Obtém o conjunto de subdistritos do Brasil a partir dos identificadores das Unidades da Federação

https://servicodados.ibge.gov.br/api/v1/localidades/estados/{UF}/subdistritos

Parâmetros

Name	Description
UF*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de subdistritos

Schema

Subdistritos por mesorregião

Obtém o conjunto de subdistritos do Brasil a partir dos identificadores das mesorregiões

https://servicodados.ibge.gov.br/api/v1/localidades/mesorregioes/{mesorregiao}/subdistritos

Parâmetros

Name	Description
mesorregiao*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de subdistritos

Schema

Subdistritos por microrregião

Obtém o conjunto de subdistritos do Brasil a partir dos identificadores das microrregiões

https://servicodados.ibge.gov.br/api/v1/localidades/microrregioes/{microrregiao}/subdistritos

Parâmetros

Name	Description
microrregiao*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de subdistritos

Schema

Subdistritos por município

Obtém o conjunto de subdistritos do Brasil a partir dos identificadores dos municípios

https://servicodados.ibge.gov.br/api/v1/localidades/municipios/{municipio}/subdistritos

Parâmetros

Name	Description
municipio*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de subdistritos

Schema

Subdistritos por região imediata

Obtém o conjunto de subdistritos do Brasil a partir dos identificadores das regiões imediatas

https://servicodados.ibge.gov.br/api/v1/localidades/regioes-imediatas/{regiao-imediata}/subdistritos

Parâmetros

Name	Description
regiao-imediata*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de subdistritos

Schema

Subdistritos por região

Obtém o conjunto de subdistritos do Brasil a partir dos identificadores das regiões

https://servicodados.ibge.gov.br/api/v1/localidades/regioes/{macrorregiao}/subdistritos

Parâmetros

Name	Description
macrorregiao*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de subdistritos

Schema

Subdistritos

Obtém o conjunto de subdistritos do Brasil

https://servicodados.ibge.gov.br/api/v1/localidades/subdistritos

Parâmetros

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de subdistritos

Schema

Subdistritos por identificador

Obtém o conjunto de subdistritos do Brasil a partir dos respectivos identificadores

https://servicodados.ibge.gov.br/api/v1/localidades/subdistritos/{id}/

Parâmetros

Name	Description
id*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de subdistritos

Schema

UFs

Obtém o conjunto de Unidades da Federação do Brasil

https://servicodados.ibge.gov.br/api/v1/localidades/estados

Parâmetros

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Array de Unidades da Federação

Schema

UF por identificador

Obtém o conjunto de Unidades da Federação do Brasil a partir dos respectivos identificadores

https://servicodados.ibge.gov.br/api/v1/localidades/estados/{UF}

Parâmetros

Name	Description
UF*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um objeto - Caso apenas um identificador seja informado - ou um array de Unidades da Federação

Schema

UFs por região

Obtém o conjunto de Unidades da Federação do Brasil a partir dos identificadores da regiões

https://servicodados.ibge.gov.br/api/v1/localidades/regioes/{macrorregiao}/estados

Parâmetros

Name	Description
macrorregiao*

Query parameters

Name	Description
orderBy
view

Responses

Status: 200 - Um array de Unidades da Federação

Schema

Query Builder

Nível geográfico

Generated 2025-06-16T15:45:36.920-03:00