Listar estados e comarcas
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){
"statusCode": 200,
"message": null,
"data": {
"AL": [
"MACEIO"
],
"BA": [
"SALVADOR"
],
"CE": [
"FORTALEZA"
],
"DF": [
"BRASILIA"
],
"ES": [
"VITORIA"
],
"GO": [
"ANAPOLIS",
"GOIANIA"
],
"MA": [
"SAO_LUIS"
],
"MG": [
"BELO_HORIZONTE",
"CARATINGA",
"DIVINOPOLIS",
"UBERLANDIA"
],
"MS": [
"CAMPO_GRANDE"
],
"PA": [
"BELEM"
],
"PB": [
"JOAO_PESSOA"
],
"PE": [
"RECIFE"
],
"PI": [
"TERESINA"
],
"RJ": [
"RIO_DE_JANEIRO"
],
"RS": [
"PORTO_ALEGRE"
],
"SP": [
"CAMPINAS",
"SAO_PAULO",
"SOROCABA"
]
}
}Endpoints
Estados e comarcas
Lista as comarcas cadastradas, agrupadas por UF, com os valores aceitos em POST /diligences/emit
GET
/
diligences
/
districts
Listar estados e comarcas
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){
"statusCode": 200,
"message": null,
"data": {
"AL": [
"MACEIO"
],
"BA": [
"SALVADOR"
],
"CE": [
"FORTALEZA"
],
"DF": [
"BRASILIA"
],
"ES": [
"VITORIA"
],
"GO": [
"ANAPOLIS",
"GOIANIA"
],
"MA": [
"SAO_LUIS"
],
"MG": [
"BELO_HORIZONTE",
"CARATINGA",
"DIVINOPOLIS",
"UBERLANDIA"
],
"MS": [
"CAMPO_GRANDE"
],
"PA": [
"BELEM"
],
"PB": [
"JOAO_PESSOA"
],
"PE": [
"RECIFE"
],
"PI": [
"TERESINA"
],
"RJ": [
"RIO_DE_JANEIRO"
],
"RS": [
"PORTO_ALEGRE"
],
"SP": [
"CAMPINAS",
"SAO_PAULO",
"SOROCABA"
]
}
}Como usar
A resposta traz, emdata, um objeto cuja chave é a UF e o valor é a lista de comarcas daquela UF, em ordem alfabética.
Use os valores exatamente como vieram (maiúsculas, sem acento, _ no lugar de espaço) nos campos state e district de POST /diligences/emit. Comarca que não existe na UF informada gera 400 com a mensagem Invalid district <COMARCA> in state <UF>.
Exemplo de resposta (resumido)
{
"statusCode": 200,
"message": null,
"data": {
"AL": ["MACEIO"],
"BA": ["SALVADOR"],
"CE": ["FORTALEZA"],
"DF": ["BRASILIA"],
"ES": ["VITORIA"],
"GO": ["ANAPOLIS", "GOIANIA"],
"MA": ["SAO_LUIS"],
"MG": ["BELO_HORIZONTE", "CARATINGA", "DIVINOPOLIS", "UBERLANDIA"],
"MS": ["CAMPO_GRANDE"],
"PA": ["BELEM"],
"PB": ["JOAO_PESSOA"],
"PE": ["RECIFE"],
"PI": ["TERESINA"],
"RJ": ["RIO_DE_JANEIRO"],
"RS": ["PORTO_ALEGRE"],
"SP": ["CAMPINAS", "SAO_PAULO", "SOROCABA"]
}
}
Próximos passos
- Emitir diligência →
POST /diligences/emitcom os valores retornados emstateedistrict. - Certidões por UF → Certidões e emissores.
Authorizations
Token de API gerado no dashboard, enviado no header X-Api-Token.