Listar publicações no modo padrão ou agrupado.
GET · API de Integração v2
/v2/publicacoesListar publicações individuais
Consulta as publicações do escritório autenticado para uma data de publicação. A identidade do escritório vem do token; não envie clienteId na URL.
Data: dataInicio é opcional e usa o formato yyyy-MM-dd. Esta rota representa uma única data: na ausência de dataInicio usa dataFim; sem ambas retorna página vazia. Para consultar um intervalo e receber totais por diário, use GET /v2/publicacoes/agrupamentos.
Modo: PADRAO é o default. AGRUPADA traz pais e publicações sem grupo; filhos são filtrados antes do total e da paginação. O modo não define o alcance das ações de tratamento.
Listas: repita o parâmetro para informar mais de um id, por exemplo responsavelIds=10&responsavelIds=20.
Contexto: cada item mantém todos os vínculos em processos, incluindo processos sem tribunal. Cada vínculo contém marcadores com id, titulo e cor; ausência retorna lista vazia. Marcadores pertencem ao processo indicado e ao cliente autenticado. Responsáveis mantêm a composição histórica por número.
| FILTROS DA CONSULTA | ||
|---|---|---|
| Campo | Exemplo | Regra |
| uf | SP | Opcional. Filtra a UF do diário. |
| siglaDiario | TJSPDJN | Opcional. Use /v2/publicacoes/opcoes/diarios para descobrir as opções disponíveis. |
| dataInicio | 2026-09-24 | Opcional. Data civil da publicação, no formato yyyy-MM-dd; na ausência usa dataFim. Sem ambas retorna página vazia. |
| dataDisponibilizacaoInicio / dataDisponibilizacaoFim | 2026-09-23 | Opcional. Restringe pelo intervalo de disponibilização. |
| lido | true | Opcional. true traz tratadas, incluindo descartadas; false traz não tratadas; ausente traz todas. |
| numeroProcesso | 0001234-56.2026.8.26.0001 | Opcional. Busca textual pelo número do processo. |
| responsavelIds / equipeIds | 10, 20 | Opcional. Filtros por responsáveis ou equipes vinculadas ao processo. |
| somenteSemResponsaveis | true | Opcional. Só true restringe a processos sem responsáveis; ausente ou false não aplica esse filtro. |
| processoCadastro | CADASTRADOS | Opcional. Um de: TODOS (padrão), CADASTRADOS ou NAO_CADASTRADOS. |
| pagina / tamanho | 1 / 15 | Opcional. Página começa em 1; tamanho padrão é 15 e o máximo é 100. |
Autenticação
X-API-Key no cabeçalho. Como autenticar
Parâmetros de consulta15
dataDisponibilizacaoFimstringFim do intervalo de disponibilização.
dataDisponibilizacaoIniciostringInício do intervalo de disponibilização.
dataFimstringData alternativa, usada somente quando dataInicio não é informada.
dataIniciostringData da publicação; na ausência usa dataFim. Sem ambas retorna página vazia.
equipeIdsarrayIDs das equipes. Repita o parâmetro para vários IDs.
lidobooleantrue para tratadas, false para não tratadas; ausente traz todas.
modoListagemstringPADRAO lista todos; AGRUPADA lista pais e publicações sem grupo.
numeroProcessostringBusca textual pelo número do processo.
paginaintegerPágina, iniciando em 1.
processoCadastrostringSituação de cadastro do processo.
responsavelIdsarrayIDs dos responsáveis. Repita o parâmetro para vários IDs.
siglaDiariostringSigla do diário obtida em /v2/publicacoes/opcoes/diarios.
somenteSemResponsaveisbooleantrue restringe a processos sem responsáveis.
tamanhointegerItens por página, entre 1 e 100.
ufstringUF do diário, por exemplo SP.
Respostas5
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": [
{
"id": "507f1f77bcf86cd799439011",
"numeroProcesso": "0001234-56.2026.8.26.0001",
"nomeDiario": "Diário da Justiça Eletrônico",
"siglaDiario": "DJEN",
"vara": "3ª Vara Cível",
"orgao": "Tribunal de Justiça de São Paulo",
"termoPesquisado": "Empresa Exemplo Ltda.",
"dataPublicacao": "2026-09-28",
"dataDisponibilizacao": "2026-09-27",
"dataRecebimento": "2026-09-27T06:15:00",
"conteudoPublicacao": "Publicação fictícia usada somente na documentação da API.",
"lido": 1,
"status": "TRATADA",
"statusDescricao": "Publicação tratada",
"sugestaoIa": {
"resumo": "Há intimação para manifestação.",
"prazos": [
{
"dias": 15,
"inicio": "2026-09-28",
"fim": "2026-10-13",
"descricao": "Manifestação processual"
}
],
"audiencias": [
{
"data": "2026-10-15",
"horario": "14:00",
"plataforma": "Microsoft Teams",
"local": "Sala virtual 1",
"endereco": null,
"modalidade": "VIRTUAL",
"observacoes": "Participação remota."
}
],
"proximosPassos": [
"Revisar o prazo sugerido",
"Definir responsável"
]
},
"ultimaAcao": {
"acao": "CONCLUIR",
"dataHora": "2026-09-27T09:45:00",
"ator": {
"id": 10,
"nome": "Usuário de exemplo",
"email": "usuario@example.invalid"
},
"motivo": "Tratamento de exemplo",
"antes": {
"lido": 0,
"status": "NAO_TRATADA"
},
"depois": {
"lido": 1,
"status": "TRATADA"
}
},
"processos": [
{
"id": 42,
"numeroProcesso": "0001234-56.2026.8.26.0001",
"tribunalId": 3,
"tribunal": "TJSP",
"partes": "Empresa Exemplo Ltda. x Parte Exemplo",
"novo": true,
"encerrado": false,
"suspenso": false,
"semMovimentacao": false,
"probabilidadeEmBaixa": false,
"segredoJustica": false,
"monitorado": true,
"favorito": true,
"responsaveis": [
{
"userId": 10,
"nome": "Usuário de exemplo",
"foto": null,
"tribunais": [
"TJSP",
"TRT2"
]
}
],
"marcadores": [
{
"id": 7,
"titulo": "Urgente",
"cor": "#DC2626"
}
],
"equipes": [
{
"id": 30,
"nome": "Contencioso"
}
]
}
],
"groupState": "PARENT",
"childrenCount": 2,
"childrenIds": [
"507f1f77bcf86cd799439012",
"507f1f77bcf86cd799439013"
],
"variacoesPublicacaoExtraidas": {
"children": [
{
"childId": "507f1f77bcf86cd799439012",
"deltaTexto": "Trecho complementar da publicação."
}
]
}
}
],
"page": 1,
"perPage": 15,
"total": 1,
"totalPages": 1
}Contrato de respostas
200Página de publicações.
Página de publicações.
application/json
contentobject[]pageintegerperPageintegertotalintegertotalPagesinteger400Filtro inválido, inclusive data fora de yyyy-MM-dd.
Filtro inválido, inclusive data fora de yyyy-MM-dd.
application/json
codestringcorrelationIdstringdetailstringerrorsErroItemApiResponse[]Ver propriedades
codestringCódigo estável do erro
fieldstringCampo relacionado
messagestringMensagem segura
instancestringrequestIdstringstatusintegertitlestringtypestring401Não autenticado; a camada de segurança encerra a requisição antes do controller.
Não autenticado; a camada de segurança encerra a requisição antes do controller.
O contrato não declara um corpo para esta resposta.
403Sem permissão para consultar; a camada de segurança encerra a requisição antes do controller.
Sem permissão para consultar; a camada de segurança encerra a requisição antes do controller.
O contrato não declara um corpo para esta resposta.
500Erro interno ao consultar a fonte de publicações.
Erro interno ao consultar a fonte de publicações.
application/json
codestringcorrelationIdstringdetailstringerrorsErroItemApiResponse[]Ver propriedades
codestringCódigo estável do erro
fieldstringCampo relacionado
messagestringMensagem segura
instancestringrequestIdstringstatusintegertitlestringtypestring