A API da JUDIT oferece a possibilidade de buscar processos judiciais usando a rota /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. Os valores possíveis são: cpf, cnpj, oab, name, lawsuit_cnj ou lawsuit_id. Para buscas processuais, utilizaremos especificamente lawsuit_cnj ou lawsuit_id, que correspondem ao número do processo.
  • search_key: O número do processo (Código CNJ), CPF, CNPJ, OAB ou Name que você deseja buscar, para busca processual será sempre o número do processo;
  • 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_response Define se a resposta virá minificada. Este parâmetro é aplicável apenas a consultas (simples ou completas) por documento no contexto de busca processual. - masked_response = true: retornará uma consulta completa - masked_response = false: retornará uma consulta simples *Obs Consulte 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.
Caso o processo tenha um ou mais processos relacionado ou em alguma outra instância, esses processos serão retornados também. Abaixo está o exemplo de como construir o payload para realizar uma busca por CNJ e obter o retorno com anexos:
{
 "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.
Abaixo está o exemplo de como construir o payload para realizar uma busca por CNJ e obter o retorno com judit IA:
{
 "search": {
  "search_type": "lawsuit_cnj",
  "search_key": "0009999-99.9999.8.26.9999"
 },
 "judit_ia": [
		"summary"
	]
}
A funcionalidade Judit IA está em versão Beta e ainda se encontra em fase de testes.
Aqui está um exemplo de como de payload para busca por lawsuit_cnj com curl:
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

{
    "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.
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'
Retorno:
{
  "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
  }
}
Através da propriedade status é possível saber se a requisição está completa.

Consultando sua request

Aqui está um exemplo de como consultar suas buscas usando curl de uma requisição através do request_id:
curl -X GET "https://requests.prod.judit.io/responses?request_id=1e6cd05b-c91a-4c14-b445-2ca96dd8a6fa"
-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:
{
 "page": 1,
 "page_data": [
  {
   "request_status": "completed",
   "request_id": "1e6cd05b-c91a-4c14-b445-2ca96dd8a6fa",
   "response_id": "e553465d-74d2-4c70-926d-a669e0ab5173",
   "origin": "api",
   "origin_id": "1e6cd05b-c91a-4c14-b445-2ca96dd8a6fa",
   "response_type": "lawsuit",
   "response_data": {
    "code": "9999999-99.9999.9.99.9999",
    "justice": "8",
    "tribunal": "19",
    "instance": 1,
    "distribution_date": "2023-06-06T17:35:50.000Z",
    "tribunal_acronym": "TJRJ",
    "secrecy_level": 0,
    "tags": {
     "is_fallback_source": true,
     "crawl_id": "3a15ad2f-3780-4699-aa6e-f602955f9008"
    },
    "subjects": [
     {
      "code": "7769",
      "name": "ABATIMENTO PROPORCIONAL DO PREÇO "
     },
     {
      "code": "7748",
      "name": "ACIDENTE AÉREO"
     },
     {
      "code": "10435",
      "name": "ACIDENTE DE TRÂNSITO"
     }
    ],
    "classifications": [
     {
      "code": "436",
      "name": "PROCEDIMENTO DO JUIZADO ESPECIAL CÍVEL"
     }
    ],
    "courts": [
     {
      "code": "13805",
      "name": "BARRA DA TIJUCA REGIONAL II JUI ESP CIV"
     }
    ],
    "parties": [
     {
      "name": "PARTE ATIVA XXXXXX",
      "side": "Active",
      "person_type": "Autor",
      "document": "99999999999",
      "document_type": "CPF",
      "lawyers": [],
      "tags": {
       "crawl_id": "3a15ad2f-3780-4699-aa6e-f602955f9008"
      }
     },
     {
      "name": "PARTE PASSIVA XXXXXXXXXX",
      "side": "Passive",
      "person_type": "Réu",
      "lawyers": [],
      "tags": {
       "crawl_id": "3a15ad2f-3780-4699-aa6e-f602955f9008"
      }
     }
    ],
    "steps": [],
    "attachments": [],
    "related_lawsuits": [],
    "crawler": {
     "source_name": "JTJ - BR - Document / Lawsuit - Auth",
     "crawl_id": "3a15ad2f-3780-4699-aa6e-f602955f9008",
     "weight": 0,
     "updated_at": "2024-03-12T19:15:41.690Z"
    },
    "amount": 28790,
    "last_step": {
     "lawsuit_cnj": "9999999-99.9999.9.99.9999",
     "lawsuit_instance": 1,
     "step_id": "nU9IcVb9NLoHrJeUXt+Hay139dqHAVbfxk7f0D77aRQ=",
     "step_date": "2024-03-12T19:15:41.690Z",
     "private": false,
     "steps_count": 1
    },
    "phase": "Inicial",
    "status": "Ativo",
    "name": "PARTE ATIVA XXXXXX X PARTE PASSIVA XXXXX"
   },
   "user_id": "6dc91e78-400e-489c-b30c-61789e323d7c",
   "created_at": "2024-03-12T19:15:42.866Z",
   "tags": {
    "dashboard_id": null
   }
  }
 ],
 "page_count": 1,
 "all_count": 4,
 "all_pages_count": 4
}
A resposta será um array 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

  {
    "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

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 ''
Não nos responsabilizamos por consulta por CNJ inválido, cobranças poderão ser efetuadas decorrente de uso indevido.