Clique na seta em "Copiar Página" para tirar dúvidas com a Inteligência Artificial.

Get all states for the current user's country

GET

https://evo-integracao-api.w12app.com.br/api/v1/states

States

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.

🔑 Parâmetros de Consulta

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

Requisição

Authorization

Basic Auth

Envie suas requisições HTTP com um cabeçalho

Authorization

que contenha a palavra Basic seguida por um espaço e uma string codificada em base64 username:password

Exemplo:

Authorization: Basic *****************

Exemplos de Requisição

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://evo-integracao-api.w12app.com.br/api/v1/states' \
--header 'Authorization: Basic <encoded-value>'

Respostas

🟢200OK

application/json

Success

Body

Exemplo

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

🟠400Bad Request

Modificado em 2026-01-16 17:54:31