Listar estados e comarcas disponíveis
curl --request GET \
--url https://api.dihub.com.br/diligences/districts \
--header 'X-Api-Token: <api-key>'const options = {method: 'GET', headers: {'X-Api-Token': '<api-key>'}};
fetch('https://api.dihub.com.br/diligences/districts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.dihub.com.br/diligences/districts"
headers = {"X-Api-Token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"MG": [
"BELO_HORIZONTE",
"CARATINGA",
"DIVINOPOLIS",
"UBERLANDIA"
],
"SP": [
"CAMPINAS",
"SAO_PAULO"
],
"GO": [
"GOIANIA"
]
}{
"message": "Unauthorized"
}{
"message": "Internal Server Error"
}Endpoints
Estados e Comarcas disponíveis
Retorna a lista completa de estados (UF) e comarcas (distritos) disponíveis para emissão de diligências
GET
/
diligences
/
districts
Listar estados e comarcas disponíveis
curl --request GET \
--url https://api.dihub.com.br/diligences/districts \
--header 'X-Api-Token: <api-key>'const options = {method: 'GET', headers: {'X-Api-Token': '<api-key>'}};
fetch('https://api.dihub.com.br/diligences/districts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.dihub.com.br/diligences/districts"
headers = {"X-Api-Token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"MG": [
"BELO_HORIZONTE",
"CARATINGA",
"DIVINOPOLIS",
"UBERLANDIA"
],
"SP": [
"CAMPINAS",
"SAO_PAULO"
],
"GO": [
"GOIANIA"
]
}{
"message": "Unauthorized"
}{
"message": "Internal Server Error"
}Como usar
Consulte este endpoint sempre que precisar saber em quais estados e comarcas a DiHub atende no momento. A resposta vem como um objeto onde a chave é a sigla do estado (UF) e o valor é a lista de comarcas disponíveis naquele estado. Use o resultado para preencher seletores na sua aplicação ou para validar os camposstate e district antes de chamar POST /diligences/emit.
Exemplo de resposta
{
"MG": ["BELO_HORIZONTE", "CARATINGA", "DIVINOPOLIS", "UBERLANDIA"],
"SP": ["CAMPINAS", "SAO_PAULO"],
"GO": ["GOIANIA"]
}
Próximos passos
- Emitir diligência →
POST /diligences/emitusando os valores retornados nos camposstateedistrict. - Estados e órgãos emissores → veja Estados e Órgãos Emissores para a lista de estados atendidos e dos órgãos que emitem certidões.