Cidades

Parâmetro Descrição
name Nome da Cidade
state Sigla dos Estados Brasileiros.
city_code Código da cidade conforme IBGE. Códigos
status testing se a cidade está em homologação e ok se ela já foi homologada.

Você pode consultar todas as cidades suportadas para emissão de NFSe no Emites.

Listagem

Lista todas as cidades:

GET /api/v1/cities

Cabeçalho de exemplo da resposta:

Status Code: 200
Date: Wed, 25 Mar 2015 14:23:28 GMT
Vary: Accept
Allow: GET, HEAD, OPTIONS
Content-Type: application/json

Corpo de exemplo da resposta:

{
    "count": 3,
    "next": null,
    "previous": null,
    "collection": [
        {
            "name": "Niterói",
            "state": "RJ",
            "city_code": 3303302,
            "status": "ok"
        },
        {
            "name": "São Paulo",
            "state": "SP",
            "city_code": 3550308,
            "status": "ok"
        },
        {
            "name": "Rio de Janeiro",
            "state": "RJ",
            "city_code": 3304557,
            "status": "ok"
        }
    ]
}

Filtros

Para filtrar uma listagem de Cidades:

GET /api/v1/cities?name=rio
Parâmetro Exemplo
name /api/v1/cities?name=rio
state /api/v1/cities?state=RJ

Você pode agrupar filtros, como no exemplo abaixo:

GET /api/v1/cities?name=rio&state=RJ

Todos os parâmetros devem ser URL Enconded