/requests.
Rota de Consulta de Processos
Nesta rota, é possível buscar processos (Código CNJ), documentos (CPF ou CNPJ), OAB ou nome. Nesta seção, abordaremos exclusivamente as buscas processuais. Para buscar um processo, você deve realizar uma solicitação POST para a rota/requests.
Payload da Solicitação
A solicitação POST deve incluir um payload com as seguintes propriedades:-
search_type: Este campo define o tipo de entidade que será buscada. O valor para consulta processual será semprelawsuit_cnj. -
search_key: O número do processo (Código CNJ) que você deseja buscar. -
cache_ttl_in_days(opcional): Número inteiro que define até quantos dias o resultado da busca pode considerar um cache válido; -
with_attachments(opcional): Esse campo define se você quer trazer anexos referente ao processo buscado podendo ser true ou false -
search_params: Um objeto que contém alguns parâmetros da busca como:lawsuit_instance(opcional): Este parâmetro permite definir a instância em que deseja buscar o processo;masked_responseDefine se a resposta virá minificada. Este parâmetro é aplicável apenas a consultas (simples ou completas) por documento no contexto de busca processual.
ObsConsulte as condições comerciais desses diferentes tipos de consultas por documento. -
judit-ia(opcional): Array de strings que define quais análises da Judit IA devem ser aplicadas à consulta. Atualmente, é possível utilizar o valor “summary” para obter um resumo automático do processo retornado na consulta processual.
Copy
{
"search": {
"search_type": "lawsuit_cnj",
"search_key": "0009999-99.9999.8.26.9999"
},
"with_attachments": true
}
O parâmetro
with_attachments determina se a busca incluirá ou não os anexos, conforme o valor booleano especificado.Copy
{
"search": {
"search_type": "lawsuit_cnj",
"search_key": "0009999-99.9999.8.26.9999"
},
"judit_ia": [
"summary"
]
}
A funcionalidade Judit IA está na versão Beta e ainda se encontra em fase de testes.
Copy
curl -X POST "https://requests.prod.judit.io/requests"
-H "api-key: YOUR_API_KEY"
-H "Content-Type: application/json"
-d
'{
"search": {
"search_type": "lawsuit_cnj",
"search_key": "0009999-99.9999.8.26.9999"
},
"with_attachments": true
}'
Aqui está o exemplo do retorno da criação da sua request feita por cnj
Copy
{
"request_id": "84b4d8f5-50f8-4c14-818f-912c722a6908",
"search": {
"search_type": "lawsuit_cnj",
"search_key": "9999999-99.9999.9.99.9999",
"response_type": "lawsuit",
"search_params": {
"public_search": false,
"filter": {},
"pagination": {}
}
},
"with_attachments": true,
"callback_url": "https://webhook.site/789d7e03-f06b-4371-bd07-880bbc635564",
"origin": "api",
"origin_id": "84b4d8f5-50f8-4c14-818f-912c722a6908",
"user_id": "7f8065a3-4891-428d-9456-dedfc12ff850",
"status": "completed",
"created_at": "2024-06-18T22:03:35.560Z",
"updated_at": "2024-06-18T22:03:41.247Z",
"tags": {
"dashboard_id": null
}
}
Consultar o status da request
Esta é uma etapa importante para saber quando a consulta terminou,
já que as respostas serão adicionadas de forma incremental por tribunal.
Copy
curl --request GET
--url 'https://requests.prod.judit.io/requests/05ee9825-b2b4-480b-b29e-f071ca7d9c72'
--header 'api-key: SUA-API-KEY'
--header 'Content-Type: application/json'
Copy
{
"request_id": "05ee9825-b2b4-480b-b29e-f071ca7d9c72",
"search": {
"search_type": "lawsuit",
"search_key": "9999999-99.9999.9.99.9999",
"response_type": "lawsuit",
"search_params": {
"filter": {},
"pagination": {}
}
},
"origin": "api",
"origin_id": "46fac09a-b34f-4dfd-a24f-b358bf04dfd4",
"user_id": "82082593-c664-4d7b-b174-2f0dc4791daf",
"status": "completed",
"created_at": "2024-02-21T17:33:22.876Z",
"updated_at": "2024-02-21T17:33:26.316Z",
"tags": {
"dashboard_id": null
}
}
Consultando sua request
Aqui está um exemplo de como consultar suas buscas usando curl de uma requisição através dorequest_id:
Copy
curl -X GET "https://requests.prod.judit.io/responses?request_id=<REQUEST_ID>"
-H "api-key: YOUR_API_KEY"
O parâmetro
request_id é o mesmo gerado na resposta criação da request.Exemplo de response da solicitação GET acima
Aqui está um exemplo da resposta da solicitação:Exemplo de como consultar a resposta da consulta processual após status completed
Exemplo de como consultar a resposta da consulta processual após status completed
Copy
{
"request_status": "completed",
"page": 1,
"page_count": 1,
"all_pages_count": 1,
"all_count": 1,
"page_data": [
{
"request_id": "03abbf28-822e-45a0-a22c-098fbe157aa4",
"response_id": "061c60b2-7fa9-4d20-87bb-1bedd31d5572",
"origin": "api",
"origin_id": "03abbf28-822e-45a0-a22c-098fbe157aa4",
"response_type": "lawsuit",
"response_data": {
"code": "9999999-99.9999.9.99.9999",
"justice": "8",
"tribunal": "26",
"instance": 1,
"distribution_date": "2019-02-15T16:00:00.000Z",
"judge": "Usuário teste",
"tribunal_acronym": "TJSP",
"secrecy_level": 0,
"tags": {
"crawl_id": "a9b6820a-6c84-4db5-b4f4-2f1909aa3805",
"dictionary_updated_at": "2025-08-13T18:43:48.143Z"
},
"subjects": [
{
"code": "",
"name": "PAGAMENTO"
}
],
"classifications": [
{
"code": "7",
"name": "PROCEDIMENTO COMUM CÍVEL"
}
],
"courts": [
{
"name": "1ª Vara Cível"
}
],
"parties": [
{
"main_document": "99999999999",
"name": "Usuário 2",
"side": "Passive",
"person_type": "Desconhecido",
"documents": [
{
"document": "99999999999",
"document_type": "cpf"
}
],
"lawyers": [
{
"name": "Usuário 3",
"documents": []
}
]
},
{
"main_document": "99999999999",
"name": "Usuário 4",
"side": "Active",
"person_type": "Desconhecido",
"documents": [
{
"document": "99999999999",
"document_type": "cnpj"
}
],
"lawyers": [
{
"name": "Usuário 5",
"documents": []
}
]
},
{
"name": "Usuário 4",
"side": "Active",
"person_type": "Desconhecido",
"documents": [],
"lawyers": [
{
"name": "Usuário 5",
"documents": []
}
]
},
{
"name": "Usuário 2",
"side": "Passive",
"person_type": "Desconhecido",
"documents": [],
"lawyers": [
{
"name": "Usuário 3",
"documents": []
}
]
},
{
"name": "Usuário 5",
"side": "Active",
"person_type": "Advogado",
"documents": []
},
{
"name": "Usuário 3",
"side": "Passive",
"person_type": "Advogado",
"documents": []
}
],
"steps": [
{
"lawsuit_cnj": "9999999-99.9999.9.99.9999",
"lawsuit_instance": 1,
"step_date": "2019-07-16T00:00:00.000Z",
"private": false,
"tags": {
"crawl_id": "36fc0ffd-98fa-4990-bd6f-6a82e5565119"
},
"step_id": "56174b2e",
"content": "Início da Execução Juntado\n0003695-16.2019.8.26.0189 - Cumprimento de sentença",
"steps_count": 32,
"created_at": "2025-07-09T13:48:33.114Z",
"updated_at": "2025-08-11T18:57:39.041Z"
},
{
"lawsuit_cnj": "9999999-99.9999.9.99.9999",
"lawsuit_instance": 1,
"step_date": "2019-06-06T00:00:00.000Z",
"private": false,
"tags": {
"crawl_id": "36fc0ffd-98fa-4990-bd6f-6a82e5565119"
},
"step_id": "939794b9",
"content": "Arquivado Definitivamente",
"created_at": "2025-07-09T13:48:33.114Z",
"updated_at": "2025-08-11T18:57:39.041Z"
},
{
"lawsuit_cnj": "9999999-99.9999.9.99.9999",
"lawsuit_instance": 1,
"step_date": "2019-06-06T00:00:00.000Z",
"private": false,
"tags": {
"crawl_id": "36fc0ffd-98fa-4990-bd6f-6a82e5565119"
},
"step_id": "423978eb",
"content": "Trânsito em Julgado às partes\nCertidão de trânsito em julgado e remessa ao arquivo geral",
"created_at": "2025-07-09T13:48:33.114Z",
"updated_at": "2025-08-11T18:57:39.041Z"
}
],
"attachments": [
{
"attachment_id": "60153051-1-1",
"attachment_date": "2019-02-15T16:00:41.000Z",
"attachment_name": "Petição (Outras)",
"extension": "pdf",
"status": "done",
"tags": {
"crawl_id": "424cd251-3d1f-407e-9d17-cb61219545aa"
},
"user_data": null
},
{
"attachment_id": "60153057-5-1",
"attachment_date": "2019-02-15T16:00:42.000Z",
"attachment_name": "Instrumento de Procuração",
"extension": "pdf",
"status": "done",
"tags": {
"crawl_id": "424cd251-3d1f-407e-9d17-cb61219545aa"
},
"user_data": null
},
{
"attachment_id": "60153061-6-1",
"attachment_date": "2019-02-15T16:00:43.000Z",
"attachment_name": "Guia",
"extension": "pdf",
"status": "done",
"tags": {
"crawl_id": "424cd251-3d1f-407e-9d17-cb61219545aa"
},
"user_data": null
},
{
"attachment_id": "60153064-7-1",
"attachment_date": "2019-02-15T16:00:44.000Z",
"attachment_name": "Guia",
"extension": "pdf",
"status": "done",
"tags": {
"crawl_id": "424cd251-3d1f-407e-9d17-cb61219545aa"
},
"user_data": null
}
],
"related_lawsuits": [],
"crawler": {
"source_name": "JSaj - TJ - SP - Lawsuit - Auth - 1 instance",
"crawl_id": "a9b6820a-6c84-4db5-b4f4-2f1909aa3805",
"weight": 10,
"updated_at": "2025-08-13T18:43:47.770Z"
},
"metadata": {},
"county": "VARA JUIZADO ESP. CIVEL CRIM. DE FERNANDOPOLIS",
"amount": 5798,
"state": "SP",
"city": "FERNANDOPOLIS",
"justice_description": "JUSTIÇA ESTADUAL",
"last_step": {
"lawsuit_cnj": "9999999-99.9999.9.99.9999",
"lawsuit_instance": 1,
"step_date": "2019-07-16T00:00:00.000Z",
"private": false,
"tags": {
"crawl_id": "a9b6820a-6c84-4db5-b4f4-2f1909aa3805"
},
"step_id": "56174b2e",
"content": "Início da Execução Juntado\n0003695-16.2019.8.26.0189 - Cumprimento de sentença",
"steps_count": 32
},
"phase": "Execução ou cumprimento",
"status": "Ativo",
"name": "Usuário 4 X Usuário 2",
"created_at": "2025-08-13T18:43:51.016Z",
"updated_at": "2025-08-13T18:43:51.016Z",
"free_justice": false
},
"user_id": "7f8065a3-4891-428d-9456-dedfc12ff850",
"created_at": "2025-08-13T18:40:54.982Z",
"request_created_at": "2025-08-13T18:40:54.037Z",
"tags": {
"debug": true,
"dashboard_id": null,
"cached_response": false,
"cached": false
}
}
]
}
A resposta com a capa processual será um array dentro de
page_data onde cada objeto corresponde a uma instância.Verifique o parâmetro
request_status para garantir que a resposta foi processada com sucesso. O valor deve ser completed. Caso contrário, a solicitação ainda está em processamento.Exemplo de resposta da consulta com Judit IA
Exemplo de resposta da consulta com Judit IA
Exemplo de resposta da consulta com Judit IA
Copy
{
"request_status": "completed",
"page": 1,
"page_count": 2,
"all_pages_count": 1,
"all_count": 2,
"page_data": [
{
"request_id": "23b7dc9c-2634-4020-98a4-6b0aee32cedf",
"response_id": "239f69b3-765b-4d84-af6c-2d151b0a9d12",
"origin": "api",
"origin_id": "23b7dc9c-2634-4020-98a4-6b0aee32cedf",
"response_type": "lawsuit",
"response_data": {
"code": "9999999-99.9999.9.99.9999",
"justice": "8",
"tribunal": "13",
"instance": 2,
"judge": "Usuário 1",
"tribunal_acronym": "TJMG",
"secrecy_level": 0,
"tags": {
"crawl_id": "5e0dd18f-8b17-47e6-a664-4ba6a06a8dcc",
"dictionary_updated_at": "2025-07-17T20:21:36.357Z"
},
"subjects": [],
"classifications": [
{
"code": "120",
"name": "MANDADO DE SEGURANÇA CÍVEL"
}
],
"courts": [
{
"name": "ÓRGÃO ESPECIAL"
}
],
"parties": [
{
"name": "USUÁRIO 1",
"side": "Passive",
"person_type": "Impetrado",
"documents": []
},
{
"name": "USUÁRIO 2",
"side": "Active",
"person_type": "Recorrente",
"documents": []
}
],
"steps": [
{
"lawsuit_cnj": "9999999-99.9999.9.99.9999",
"lawsuit_instance": 2,
"step_id": "9999ca",
"step_date": "2025-07-09T21:00:00.000Z",
"content": "Diligências Cartorárias ou de Ofício - : enviado email à advogada da impetrante com instruções para se cadastrar no SEI",
"private": false,
"tags": {
"crawl_id": "5e0dd18f-8b17-47e6-a664-4ba6a06a8dcc"
},
"steps_count": 101
},
{
"lawsuit_cnj": "9999999-99.9999.9.99.9999",
"lawsuit_instance": 2,
"step_id": "38683fff",
"step_date": "2025-07-09T08:40:00.000Z",
"content": "Juntada de petição eletrônica - Protocolo Eletrônico: 0622572-73.2014.8.13.0000/004.033 Documento: Petição",
"private": false,
"tags": {
"crawl_id": "5e0dd18f-8b17-47e6-a664-4ba6a06a8dcc"
}
}
],
"attachments": [
{
"attachment_id": "629104438",
"status": "done",
"user_data": null,
"tags": {
"crawl_id": "207ccc3f-f17e-46dd-9ea0-7620c9c313d8"
},
"attachment_name": "PETICAO_INTERMEDIARIA_INFORMAÇÕES.pdf",
"content": "Informações",
"extension": "pdf"
},
{
"attachment_id": "628789282",
"status": "done",
"user_data": null,
"tags": {
"crawl_id": "207ccc3f-f17e-46dd-9ea0-7620c9c313d8"
},
"attachment_name": "Reforço de tese - Augusto 2025.pdf",
"content": "Petição",
"extension": "pdf"
}
],
"related_lawsuits": [],
"crawler": {
"source_name": "JPE - TJMG - 2º grau - Auth",
"crawl_id": "5e0dd18f-8b17-47e6-a664-4ba6a06a8dcc",
"weight": 5,
"updated_at": "2025-07-17T20:21:34.229Z"
},
"county": "1ª VICE-PRESIDÊNCIA",
"state": "MG",
"city": "BELO HORIZONTE",
"justice_description": "JUSTIÇA ESTADUAL",
"last_step": {
"lawsuit_cnj": "9999999-99.9999.9.99.9999",
"lawsuit_instance": 2,
"step_id": "d72efdfd",
"step_date": "2025-06-09T11:28:00.000Z",
"content": "Juntada de petição eletrônica - Protocolo Eletrônico: 0622572-73.2014.8.13.0000/000.052 Documento: Informações",
"private": false,
"tags": {
"crawl_id": "5e0dd18f-8b17-47e6-a664-4ba6a06a8dcc"
},
"steps_count": 94
},
"phase": "Execução ou cumprimento",
"status": "Ativo",
"name": "USUÁRIO 1 X USUÁRIO 2",
"amount": 0,
"created_at": "2025-07-17T20:21:49.595Z",
"updated_at": "2025-07-17T20:21:49.595Z",
"metadata": {},
"free_justice": false,
"distribution_date": "1999-12-31T21:00:00.000Z"
},
"user_id": "7f8065a3-4891-428d-9456-dedfc12ff850",
"created_at": "2025-07-17T20:21:23.698Z",
"request_created_at": "2025-07-17T20:21:21.322Z",
"tags": {
"dashboard_id": null,
"cached_response": false
}
},
{
"request_id": "23b7dc9c-2634-4020-98a4-6b0aee32cedf",
"response_id": "d09adf5b-6ad5-402a-a551-2cc4e4434cad",
"origin": "api",
"origin_id": "23b7dc9c-2634-4020-98a4-6b0aee32cedf",
"response_type": "summary",
"response_data": {
"data": [
"## Resumo\nO processo de número <strong className=\"text-primary\">9999999-99.9999.9.99.9999</strong> é uma ação de Usucapião Ordinária, tramitada na Justiça Estadual, mais especificamente no Tribunal de Justiça do Estado de São Paulo (TJSP). O processo foi distribuído na data de 0 de outubro de 0000 e foi julgado pela juíza Usuário1 na 6ª Vara Cível do foro de Sorocaba. Concluiu-se com uma Baixa Definitiva em 0 de fevereiro de 0000, indicando sua finalização no sistema judicial.\n\n## Partes\n<ul>\n <li>\n <p>\n <strong className=\"text-foreground text-base leading-5 font-semibold\">Usuário2</strong>\n <span className=\"text-muted-foreground text-sm\"></span>\n <br />\n <p className=\"text-foreground/70 text-md font-normal\">\n Usuário2 é o autor da ação, pessoa que iniciou o processo judicial requerendo o reconhecimento do seu direito de propriedade sobre um imóvel por meio de usucapião.\n </p>\n <br className=\"last-of-type:hidden\"/>\n </p>\n </li>\n <li>\n <p>\n <strong className=\"text-foreground text-base leading-5 font-semibold\">Usuário3</strong>\n <span className=\"text-muted-foreground text-sm\">Advogado</span>\n <br />\n <p className=\"text-foreground/70 text-md font-normal\">\n Usuário3 é o advogado responsável por representar o autor, USUÁRIO4, em todos os trâmites legais do processo.\n </p>\n <br className=\"last-of-type:hidden\"/>\n </p>\n </li>\n</ul>\n\n## Classe\n<ul>\n <li>\n <p>\n <strong className=\"text-foreground text-base leading-5 font-semibold\">Usucapião</strong>\n <br />\n <p className=\"text-foreground/70 text-md font-normal\">\n A classe do processo se refere a uma forma de aquisição da propriedade de um imóvel em decorrência de sua posse prolongada e ininterrupta, de acordo com requisitos legais.\n </p>\n </p>\n </li>\n</ul>\n\n## Assuntos\n<ul>\n <li>\n <p>\n <strong className=\"text-foreground text-base leading-5 font-semibold\">Usucapião Ordinária</strong>\n <br />\n <p className=\"text-foreground/70 text-md font-normal\">\n Trata-se de um tipo específico de usucapião em que é exigido um prazo de posse do imóvel de, no mínimo, dez anos, com base na boa-fé e justo título ou quinze anos, independentemente destes requisitos.\n </p>\n <br />\n </p>\n </li>\n</ul>\n\n## Movimentações\n<p className=\"text-foreground/70\">\n O processo teve diversas movimentações importantes. Em <span className=\"text-primary\">00 de setembro de 0000</span>, houve uma decisão homologando a desistência do autor Tiago Martins da Silva e, em consequência, o processo foi extinto sem resolução de mérito por desistência, sem necessidade de recolher custas finais devido à gratuidade da justiça já concedida. No mesmo dia, foi determinado o trânsito em julgado, ou seja, a decisão tornou-se definitiva, sem possibilidade de recursos. Em <span className=\"text-primary\">0 de fevereiro de 0000</span>, foi realizada a baixa definitiva do processo, marcando sua conclusão no sistema judicial.\n</p>"
],
"origin_id": "8a8f07b8-066c-4bb1-a7bd-071fb35b73b2",
"origin": "response"
},
"user_id": "7f8065a3-4891-428d-9456-dedfc12ff850",
"created_at": "2025-07-17T20:23:36.427Z",
"request_created_at": "2025-07-17T20:21:21.941Z"
}
]
}
Consultando anexo capturado
Copy
curl -X GET --location 'https://lawsuits.production.judit.io/lawsuits/<número do processo>/<intancia>/attachments/<attachment_id>' \
--header 'api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data ''
Informações sobre anexos retornados na resposta da consulta:
-
status: Representa o parâmetro indica o estado da captura dos anexos. Quando o valor é “done”, significa que o anexo foi capturado com sucesso. -
attachments: Os anexos são listados como array, onde cada objeto dentro desse array representa um anexo individual. -
private: Caso o anexo seja privado no tribunal, o campo private virá com o valor booleano true. -
extension: Indica a extensão do documento (por exemplo: “pdf”, “jpg”, “docx”).