Listar processos vinculados à pessoa (paginado)
GET · API de Integração v2
/v2/pessoas/{id}/processosProcessos vinculados à pessoa
Lista os processos em que a pessoa aparece, em qualquer papel. O escritório vem da sua chave de API; apenas processos não excluídos do seu escritório entram.
Uma linha por processo. Os papéis vêm na lista vinculadoComo, porque a
mesma pessoa pode ocupar mais de um no mesmo processo — o caso comum é o advogado que também
é parte. Valores possíveis: CLIENTE (parte representada pelo escritório),
PARTE_CONTRA, ADVOGADO, ADVOGADO_CONTRA.
É o mesmo vocabulário que POST /v2/processos/pessoas aceita no campo
tipo, então o valor lido aqui pode ser reenviado na escrita sem tradução.
Tribunal: tribunal vem sempre preenchido — todo processo aponta para
uma linha de tribunais, inclusive quando não há tribunal de fato: nesses casos
vem Sem Tribunal, ou Processo Administrativo no administrativo.
Já grau pode vir nulo, porque não é toda linha de tribunais que o
define — o administrativo é um desses casos.
Pessoa inexistente, excluída, de outro escritório ou com id não positivo devolve
404 — mesma regra do GET /v2/pessoas/{id}. Lista vazia com
200 significa, e só significa, que a pessoa existe e não tem processo
vinculado.
Pessoa arquivada é listada normalmente: arquivar não esconde a pessoa desta rota.
Autenticação
X-API-Key no cabeçalho. Como autenticar
Parâmetros de caminho1
idintegerobrigatórioID da pessoa.
Parâmetros de consulta2
pageintegerPágina (1-based)
perPageintegerItens por página (default 15, máx 100)
Respostas6
Exemplos ilustrativos · nenhuma requisição é enviada
200 · Sucesso
- Quando acontece
- A operação foi concluída.
- Como tratar
- Leia os dados retornados; em listagens, confira também a paginação.
Exemplo declarado no OpenAPI · application/json
{
"content": [
{
"processoId": 26540878,
"numeroProcesso": "1011214-58.2024.8.26.0477",
"tribunal": "TJSP",
"grau": "1º Grau",
"encerrado": false,
"monitorado": true,
"vinculadoComo": [
"CLIENTE",
"ADVOGADO"
]
}
],
"page": 1,
"perPage": 15,
"total": 1,
"totalPages": 1
}Contrato de respostas
200Página de processos vinculados.
Página de processos vinculados.
application/json
encerradobooleanProcesso encerrado
graustringGrau/instância do tribunal; null quando o tribunal não define grau (ex.: administrativo)
monitoradobooleanProcesso com monitoramento ativo
numeroProcessostringNúmero do processo
processoIdintegerID interno do processo
tribunalstringNome do tribunal. Sempre preenchido: processo sem tribunal vem como "Sem Tribunal", e o administrativo como "Processo Administrativo"
vinculadoComostring[]Papéis da pessoa neste processo. Mais de um é possível (ex.: advogado que também é parte)
400ID não numérico (falha de conversão do path).
ID não numérico (falha de conversão do path).
O contrato não declara um corpo para esta resposta.
401Token inválido.
Token inválido.
O contrato não declara um corpo para esta resposta.
403Acesso negado, inclusive chamada sem token.
Acesso negado, inclusive chamada sem token.
O contrato não declara um corpo para esta resposta.
404Pessoa não encontrada — inclui id zero ou negativo.
Pessoa não encontrada — inclui id zero ou negativo.
O contrato não declara um corpo para esta resposta.
503Banco indisponível ou consulta excedeu o tempo limite.
Banco indisponível ou consulta excedeu o tempo limite.
application/json
codestringcorrelationIdstringdetailstringerrorsErroItemApiResponse[]Ver propriedades
codestringCódigo estável do erro
fieldstringCampo relacionado
messagestringMensagem segura
instancestringrequestIdstringstatusintegertitlestringtypestring