Listar Estados

Descrição

Retorna todos os estados do país associado ao usuário autenticado. Além das informações do estado (ID, nome e sigla), a resposta também inclui a hierarquia completa de cidades pertencentes a cada estado e, dentro de cada cidade, a lista de bairros.

Esse endpoint pode ser útil para cadastros, filtros e qualquer funcionalidade que exija dados geográficos estruturados.

Não requer parâmetros. A lista de estados é retornada automaticamente com base no país do usuário autenticado.

Exemplo de Resposta

[
  {
    "idEstado": 0,
    "nome": "string",
    "sigla": "string",
    "idPais": 0,
    "cidades": [
      {
        "idCidade": 0,
        "idEstado": 0,
        "nome": "string",
        "bairros": [
          {
            "idBairro": 0,
            "idCidade": 0,
            "descricao": "string"
          }
        ]
      }
    ]
  }
]