Dados Abertos - Documentação da API - Unidades Judiciárias
Esta API fornece informações sobre as unidades judiciárias, incluindo seus identificadores e eventuais atributos adicionais. Os dados estão disponíveis em formato JSON.
URL
https://dadosabertos.trt4.jus.br
endPoints
1. Consulta de Unidades Judiciárias
GET /api/enderecos/unidades
Parâmetros de Requisição
Nenhum parâmetro é necessário para esta requisição.
Estrutura da Resposta
A resposta é composta por uma lista de objetos dentro do campo unidadesJudiciarias, com os seguintes atributos:
| Campo | Tipo | Descrição |
| id | Inteiro | Identificador único da unidade |
| nome | String | Nome da unidade judiciária |
| numero | Inteiro | (Opcional) Número da unidade (pode ser null ou 0) |
| srlvara | Inteiro | (Opcional) Código de vara associada |
| srlforo | Inteiro | (Opcional) Código do foro associado |
Exemplo de Resposta
{
"unidadesJudiciarias": [
{
"id": 34,
"nome": "Alegrete",
"numero": 0
},
{
"id": 35,
"nome": "Alvorada",
"numero": 0
},
{
"id": 685,
"nome": "Bagé"
}
]
}
2. Consulta de detalhes de um Foro, Vara ou Posto Trabalhista
GET /api/enderecos/unidades/{id}
Parâmetros de Requisição
| Parâmetro | Tipo | Obrigatório | Descrição |
| id | Inteiro | Não | Identificador único do foro/vara/posto |
Estrutura da Resposta
A resposta retorna detalhes sobre o posto, vara ou foro trabalhista solicitado, incluindo suas jurisdições.
| Campo | Tipo | Descrição |
| id | Inteiro | Identificador único do foro/vara/posto |
| nome | String | Nome da jurisdição quando foro/ nome da vara/nome do posto) |
| dataInstalacao | String | Data de instalação (pode ser nulo - null) |
| telefone | String | Telefone de contato da unidade judiciária (foro/vara/posto) |
| cep | String | CEP da unidade judiciária (foro/vara/posto) |
| endereco | String | Endereço da unidade judiciária (foro/vara/posto) |
| jurisdicoes | Array | Lista de cidades que compõe a jurisdição (Detalhamento no tópico "Estrutura do objeto jurisdicoes") |
| juiz | String | Nome do juiz diretor(a) do Foro |
| juizSexo | String | Sexo do juiz diretor(a) do Foro |
| emailDCDF | String | Email da Divisão de Controle da Direção de Foro |
| telefoneDCDF | String | Telefone da Divisão de Controle da Direção de Foro |
| nomeExibicaoDCDF | String | Nome para exibição da Divisão de Controle da Direção de Foro |
| nomeChefeDCDF | String | Nome do responsável pela Divisão de Controle da Direção de Foro |
| labelCargoChefeDCDF | String | Cargo do responsável pela Divisão de Controle da Direção de Foro |
| labelBalcao | String | Texto do label para o Balcão Virtual |
| zoomBalcao | String | Link da sala de Zoom do Balcão Virtual |
| nomeExibicaoControle | String | Nome da Coordenadoria de Controle do Foro |
| emailControle | String | Email da Coordenadoria de Controle do Foro |
| nomeChefeControle | String | Nome do responsável pela Coordenadoria de Controle do Foro |
| labelCargoChefeControle | String | Cargo do responsável pela Coordenadoria de Controle do Foro |
| nomeExibicaoCM | String | Nome para exibição da Central de Mandados |
| nomeChefeCM | String | Nome do responsável pela Central de Mandados |
| labelCargoChefeCM | String | Cargo do responsável pela Central de Mandados |
| emailMandados | String | Email da Central de Mandados |
| telefoneMandados | String | Telefone da Central de Mandados |
| nomeCompleto | String | Nome completo do foro/vara/posto |
| postos | Array | Lista de postos existentes (Detalhamento no tópico "Estrutura do objeto postos" - Pode ser nulo - null) |
| varas | Array | Lista de varas existentes (Detalhamento no tópico "Estrutura do objeto varas" - Pode ser nulo - null) |
Estrutura do objeto jusridicoes
| Campo | Tipo | Descrição |
| id | Inteiro | Identificador único da jurisdição |
| cidade | String | Nome da cidade que pertence à jurisdição |
| abrangePosto | Booleano | Falso ou Verdadeiro para indicar se a cidade da jurisdição abrange o posto da JT (quando houver posto na jurisdição) |
| abrange | String | "S" ou "N" para indicar se a cidade da jurisdição abrange o posto da JT (quando houver posto na jurisdição) |
| sede | String | Indica se é ou não da cidade-sede da jurisdição |
Estrutura dos objetos postos e varas
| Campo | Tipo | Descrição |
| id | Inteiro | Identificador único da vara/posto |
| nome | String | Nome da vara/nome do posto |
| dataInstalacao | String | Data de instalação (pode ser nulo - null) |
| telefone | String | Telefone de contato da unidade judiciária (vara/posto) |
| cep | String | CEP da unidade judiciária (vara/posto) |
| endereco | String | Endereço da unidade judiciária (vara/posto) |
| String | Email da unidade judiciária (vara/posto) | |
| labelBalcao | String | Texto do label para o Balcão Virtual |
| zoomBalcao | String | Link da sala de Zoom do Balcão Virtual |
| numeroProcessual | String | Código processual da vara (opcional) |
| juizTitular | String | Nome do(a) juiz(a) Titular da vara |
| juizTitularSexo | String | Sexo do(a) juiz(a) Titular da vara |
| juizSubLotado | String | Nome do(a) juiz(a) Substitulo(a) da vara |
| juizSubDes | String | Nome do(a) juiz(a) Substitulo(a) Designado(a) da vara |
| juizSubLotadoSexo | String | Sexo do(a) juiz(a) Substitulo(a) da vara |
| juizSubDesSexo | String | Sexo do(a) juiz(a) Substitulo(a) Designado(a) da vara |
| diretor | String | Nome do diretor(a) da vara |
| diretorSexo | String | Sexo do diretor(a) da vara |
| diretorSubst | String | Nome do diretor(a) substituto(a) da vara |
| diretorSubstSexo | String | Sexo do diretor(a) substituto(a) da vara |
| nomeCompleto | String | Nome completo da vara/posto |
Códigos de Resposta
| Código | Descrição |
| 200 | Sucesso - A requisição foi processada com sucesso |
| 400 | Requisição Inválida - Algum parâmetro incorreto foi fornecido |
| 404 | Não encontrado - Nenhum foro/vara/posto correspondente ao id foi localizado |
| 500 | Erro Interno - Ocorreu um erro no servidor |