Há duas opções para consulta da lista de bairros:
GET https://api.brasilaberto.com/v1/districts/{cityId}
Nesse caso, o parâmetro cityId é o ID da cidade na nossa base, ele é retornado na API de cidades e também na consulta de CEPs.
GET https://api.brasilaberto.com/v1/districts-by-ibge-code/{ibgeCode}
Nesse caso, o ibgeCode é o código identificador da cidade, de acordo com a base do IBGE.
Supondo que você queira buscar os bairros de Nova Iguaçu:
// Esse exemplo mostra somente parte dos resultados // GET https://api.brasilaberto.com/v1/districts/669 { "meta": { "currentPage": 1, "itemsPerPage": 1910, "totalOfItems": 1910, "totalOfPages": 1 }, "result": [ { "id": 1, "name": "Sé" }, { "id": 2, "name": "Centro" }, { "id": 3, "name": "Brás" }, { "id": 4, "name": "República" }, ... ] }
200 Sucesso 404 IbgeCode inexistente 500 Erro na nossa API