A API da JUDIT oferece a possibilidade de buscar processos judiciais usando a rota /requests.

​
Rota de Consulta de Processos

Nesta rota podem ser buscado Processos (Código CNJ), documentos (CPF ou CNPJ), OAB ou Nome.

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: Esse campo define o tipo de entidade que você quer buscar. Pode ser “cpf”, “cnpj”, “oab”, name, “lawsuit_cnj” ou “lawsuit_id” para um número de processo;

Obs: - O formato da OAB é sempre UF mais 7 digitos do numero da OAB, adicionar zeros a esquerda até atingir 7 dígitos.

Exemplo:


DF0012345

Caso a OAB tenha apenas 4 dígitos, adicionar mais um zero:

DF0001234

  • search_key: O número do processo (Código CNJ), CPF, CNPJ, OAB ou Name que você deseja buscar;

  • response_type (opcional): Esse campo define o tipo de retorno dos dados da busca podendo ser “lawsuit”,“parties”, “attachments”, “steps” ou “lawsuits”;

  • 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

    • Obs: Os anexos só serão retornados caso o search_type for lawsuit_cnj ou lawsuit_id.

  • 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.

    Para buscas por documento onde o search_type seja “cpf”, “cnpj”, “oab” ou “name”.

    • filter (opcional): Um objeto que contém alguns filtros da busca como:

      • side (opcional): Este parâmetro permite buscar por tipo de participantes do processo podendo ser ‘Passive’, ‘Active’, ‘Interested’, ‘Unknown’;

      • amount_gte (opcional): Este parâmetro permite buscar por processos com valor da causa maior que o amount_gte;

      • amount_lte (opcional): Este parâmetro permite buscar por processos com valor da causa menor que o amount_lte;

      • tribunals (opcional): Um objeto que contém os filtro de tribunais;

        • keys (opcional): Este filtro é uma lista de códigos de tribunais inclusos na lista de tribunais. Você pode fornecer uma lista de códigos de tribunais para restringir a busca a processos que tenham ou não tenham esses códigos específicos;
        • not_equal (opcional): Um valor booleano que define se o filtro será para processos que contenham os valores em keys ou que não contenham os valores em keys

      • subject_codes (opcional): Um objeto que contém os filtro de assuntos;

        • keys (opcional): Este filtro é uma lista de códigos assuntos. Você pode fornecer uma lista de códigos de assuntos para restringir a busca a processos que tenham ou não tenham esses códigos específicos;
        • not_equal (opcional): Um valor booleano que define se o filtro será para processos que contenham os valores em keys ou que não contenham os valores em keys

      • classification_codes (opcional): Um objeto que contém os filtro de classes processuais;

        • keys (opcional): Este filtro é uma lista de códigos de classes processuais. Você pode fornecer uma lista de códigos de classes para restringir a busca a processos que tenham ou não tenham esses códigos específicos;
        • not_equal (opcional): Um valor booleano que define se o filtro será para processos que contenham os valores em keys ou que não contenham os valores em keys

      • distribution_date_gte (opcional): Este filtro permite que você especifique uma data de distribuição mínima. Ele ajuda a filtrar processos com base na data de distribuição, permitindo que você localize processos distribuídos após uma determinada data.

    • credential (opcional): Objeto para o uso do cofre de credenciais.

      • customer_key (opcional): Permite passar a chave do usuário que você cadastrou no cofre de credenciais, não seja informado, a API tentará encontrar uma credencial cadastrada para a customer_key vazia.

    Caso o processo tenha um ou mais processos relacionado ou em alguma outra instância, esses processos serão retornados também.

Aqui está um exemplo de como um payload pode aparecer em uma busca por documento:

{
 "search": {
  "search_type": "cpf",
  "search_key": "092.065.297-22"
 }
}

Aqui está um exemplo de como um payload pode aparecer em uma busca por cnj com retorno de anexos:

{
 "search": {
  "search_type": "lawsuit_cnj",
  "search_key": "0001234-55.2023.8.26.0100"
 },
 "with_attachments": true
}

Aqui está um exemplo de como usar esse payload de busca por documento 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": "cpf",
        "search_key": "092.065.297-22"
    }
}'

Aqui está um exemplo de como usar esse payload de 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": "0001234-55.2023.8.26.0100"
  },
  "with_attachments": true
}'

​
Aqui está o exemplo do retorno da criação da sua request feita por documento

{
 "request_id": "1e6cd05b-c91a-4c14-b445-2ca96dd8a6fa",
 "search": {
  "search_type": "cpf",
  "search_key": "092.065.297-22",
  "response_type": "lawsuits",
  "search_params": {
   "filter": {},
   "pagination": {}
  }
 },
 "origin": "api",
 "origin_id": "1e6cd05b-c91a-4c14-b445-2ca96dd8a6fa",
 "user_id": "6dc91e78-400e-489c-b30c-61789e323d7c",
 "status": "pending",
 "created_at": "2024-03-12T18:40:35.523Z",
 "updated_at": "2024-03-12T18:40:35.523Z",
 "tags": {}
}

​
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": "0001234-08.2023.8.26.0100",
        "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
    }
}

​
Consultando sua request

Aqui está um exemplo de como consultar suas buscas usando curl de uma requisição:

curl -X GET "https://requests.prod.judit.io/responses?request_id=1e6cd05b-c91a-4c14-b445-2ca96dd8a6fa"
-H "api-key: YOUR_API_KEY"

​
Consultando Informações de uma Busca

Para consultar todas as informações sobre uma busca específica, você pode fazer uma solicitação GET para a rota /requests/{busca}, substituindo {busca} pelo ID da busca que você deseja consultar.

Aqui está um exemplo de como fazer isso usando curl:

curl -X GET "https://requests.prod.judit.io/requests/{busca}"
-H "api-key: YOUR_API_KEY"

​
Retorno Esperado esperado de uma consulta por cpf

{
 "request_id": "1e6cd05b-c91a-4c14-b445-2ca96dd8a6fa",
 "search": {
  "search_type": "cpf",
  "search_key": "092.065.297-22",
  "response_type": "lawsuits",
  "search_params": {
   "filter": {},
   "pagination": {}
  }
 },
 "origin": "api",
 "origin_id": "a02d0cd6-21c7-45ca-b905-704df6afd151",
 "user_id": "6dc91e78-400e-489c-b30c-61789e323d7c",
 "status": "completed",
 "created_at": "2024-03-12T18:40:35.523Z",
 "updated_at": "2024-03-12T18:40:35.523Z",
 "tags": {}
}

​
Retorno Esperado esperado de uma consulta por cpf

{
 "request_id": "1e6cd05b-c91a-4c14-b445-2ca96dd8a6fa",
 "search": {
  "search_type": "lawsuit_cnj",
  "search_key": "0001234-55.2023.8.26.0100",
  "response_type": "lawsuits",
  "search_params": {
   "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
    }
}
  • A resposta é asyncrona, logo deverá ser esperado o status da solicitação como completed.

​
Consultando Informações de uma Resposta

Para consultar todas as informações sobre uma resposta específica, você pode fazer uma solicitação GET para a rota /responses/{resposta}, substituindo {resposta} pelo ID da resposta que você deseja consultar.

Aqui está um exemplo de como fazer isso usando curl:

curl -X GET "https://requests.prod.judit.io/responses/1e6cd05b-c91a-4c14-b445-2ca96dd8a6fa"
-H "api-key: YOUR_API_KEY"

​
Exemplo de response da solicitação GET acima

Aqui está um exemplo da resposta da solicitação:

{
 "page": 1,
 "page_data": [
  {
   "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": "0817064-37.2023.8.19.0209",
    "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": "14224726718",
      "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": "0817064-37.2023.8.19.0209",
     "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
}

Não nos responsabilizamos por consulta por documento inválido, cobranças poderão ser efetuadas decorrente de uso indevido.

Primeiros PassosMonitoramento