Brasil Aberto

🧭 Obtendo a lista de cidades de um estado

Exemplo de uso

Você deve usar a API de ceps no seguinte padrão:

GET https://api.brasilaberto.com/v1/cities/{stateShortname}

Supondo que você queira buscar as cidades do Rio de Janeiro:

// Esse exemplo mostra somente parte dos resultados // GET https://api.brasilaberto.com/v1/cities/RJ { "meta": { "currentPage": 1, "itemsPerPage": 92, "totalOfItems": 92, "totalOfPages": 1 }, "result": [ { "id": 646, "ibgeId": 3304557, "name": "Rio de Janeiro" }, { "id": 647, "ibgeId": 3302007, "name": "Itaguaí" }, { "id": 648, "ibgeId": 3302601, "name": "Mangaratiba" }, { "id": 649, "ibgeId": 3305554, "name": "Seropédica" }, { "id": 650, "ibgeId": 3300100, "name": "Angra dos Reis" }, { "id": 651, "ibgeId": 3303807, "name": "Paraty" }, { "id": 652, "ibgeId": 3303302, "name": "Niterói" }, { "id": 653, "ibgeId": 3304904, "name": "São Gonçalo" }, { "id": 654, "ibgeId": 3301900, "name": "Itaboraí" }, ... ] }

Status de retorno

200 Sucesso 404 Estado inexistente 500 Erro na nossa API