A consulta síncrona permite verificar rapidamente se um CPF, CNPJ, OAB ou nome possui processos registrados em nosso datalake. Ela retorna, de forma ágil, uma resposta indicando a existência ou não de processos. Paralelamente, uma consulta completa é acionada no datalake, cuja resposta detalhada pode ser acessada posteriormente, de maneira semelhante à consulta assíncrona.

Na consulta síncrona, são retornados apenas os dados já disponíveis em nossa base, garantindo uma resposta mais rápida. Contudo, isso pode resultar em um pequeno atraso na obtenção de informações mais completas. Para acessar dados atualizados e abrangentes, é fundamental realizar uma consulta assíncrona, que buscará diretamente nos tribunais trazendo as informações atualizadas.

1

Payload

Para realizar a consulta de forma síncrona, é necessário primeiro criar uma requisição para o endpoint de lawsuits. Abaixo, segue um exemplo de como fazer essa requisição utilizando o cURL.

curl --request POST \
--url https://lawsuits.prod.judit.io/requests/create \
--header 'Content-Type: application/json' \
--header 'api-key: <api-key>' \
--data '{
"search": {
  "search_type": "cpf",
  "search_key": "999.999.999-99",
  "search_params": {
    "pagination": {
      "page": 1,
      "page_size": 50
    }
  }
}
}'

Se desejar receber um grupo de itens específicos, a consulta pode ser realizada passando os filtros desejados.

Segue um exemplo de request utilizando filtro para TJRJ:

curl --request POST \
--url https://lawsuits.prod.judit.io/requests/create \
--header 'Content-Type: application/json' \
--header 'api-key: <api-key>' \
--data '{
"search": {
  "search_type": "cpf",
  "search_key": "999.999.999-99",
  "search_params": {
    "filter": {
      "tribunals": {
            "keys": ["TJRJ"],
          "not_equal": false
        }
    },
    "pagination": {
      "page": 1,
      "page_size": 50
    }
  }
}
}'

A resposta da requisição deverá ter um tamanho máximo de 50 itens por página (page_size).

A resposta dessa requisição será um objeto JSON com os dados da resposta:

{
"has_lawsuits": true,
"request_id": "c37cacba-41b5-4694-919f-4a937f2ea5df",
"response_data": [
{
  "code": "9999999-99.9999.9.99.9999",
  "justice": "5",
  "tribunal": "01",
  "instance": 2,
  "distribution_date": "2023-05-18T11:12:59.000Z",
  "tribunal_acronym": "TRT1",
  "secrecy_level": 0,
  "tags": {
    "is_fallback_source": true,
    "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee"
  },
  "subjects": [
    {
      "code": "13656",
      "name": "DOMÉSTICOS"
    }
  ],
  "classifications": [
    {
      "code": "1009",
      "name": "RECURSO ORDINÁRIO TRABALHISTA"
    }
  ],
  "courts": [
    {
      "code": "75580",
      "name": "GAB DES. GLAUCIA ZUCCARI FERNANDES BRAGA"
    }
  ],
  "parties": [
    {
      "name": "Usuário teste",
      "side": "Active",
      "person_type": "Autor",
      "document": "99999999999",
      "document_type": "CPF",
      "lawyers": [
        {
          "name": "Advogada do Autor",
          "side": "Active",
          "person_type": "Advogado"
        }
      ],
      "tags": {
        "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee"
      }
    },
    {
      "name": "Usuário teste",
      "side": "Passive",
      "person_type": "Réu",
      "document": "99999999999",
      "document_type": "CPF",
      "lawyers": [
        {
          "name": "Nome da advogada do réu",
          "side": "Passive",
          "person_type": "Advogado"
        }
      ],
      "tags": {
        "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee"
      }
    },
    {
      "person_type": "Advogado",
      "side": "Active",
      "name": "Nome da advogada",
      "tags": {
        "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee"
      }
    },
    {
      "person_type": "Advogado",
      "side": "Passive",
      "name": "Nome do advogado",
      "tags": {
        "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee"
      }
    }
  ],
  "steps": [],
  "attachments": [],
  "related_lawsuits": [],
  "crawler": {
    "source_name": "JTJ - BR - Document / Lawsuit - Auth",
    "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee",
    "weight": 0,
    "updated_at": "2024-03-18T19:21:02.466Z"
  },
  "amount": 7685.82,
  "last_step": {
    "lawsuit_cnj": "9999999-99.9999.9.99.9999",
    "lawsuit_instance": 1,
    "step_id": "JZzfEPTs10aeE+vpu+p+bkrz5K7enJhAM5kWattktHk=",
    "step_date": "2024-03-18T19:21:02.466Z",
    "private": false,
    "steps_count": 1
  },
  "phase": "Inicial",
  "status": "Ativo",
  "name": "Nome do Autor X Nome do Réu"
},
{
  "code": "9999999-99.9999.9.99.9999",
  "justice": "5",
  "tribunal": "01",
  "instance": 1,
  "distribution_date": "2022-03-30T16:41:24.000Z",
  "tribunal_acronym": "TRT1",
  "secrecy_level": 0,
  "tags": {
    "is_fallback_source": true,
    "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee"
  },
  "subjects": [
    {
      "code": "13656",
      "name": "DOMÉSTICOS"
    }
  ],
  "classifications": [
    {
      "code": "985",
      "name": "AÇÃO TRABALHISTA - RITO ORDINÁRIO"
    }
  ],
  "courts": [
    {
      "code": "33782",
      "name": "RIO DE JANEIRO - 37ª VARA DO TRABALHO"
    }
  ],
  "parties": [
    {
      "name": "Berenice",
      "side": "Active",
      "person_type": "Autor",
      "document": "99999999999",
      "document_type": "CPF",
      "lawyers": [
        {
          "name": "Nome do advogado do Autor",
          "side": "Active",
          "person_type": "Advogado"
        }
      ],
      "tags": {
        "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee"
      }
    },
    {
      "name": "Jhon Doe",
      "side": "Passive",
      "person_type": "Réu",
      "document": "99999999999",
      "document_type": "CPF",
      "lawyers": [
        {
          "name": "Nome da Advogada do réu",
          "side": "Passive",
          "person_type": "Advogado"
        }
      ],
      "tags": {
        "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee"
      }
    },
    {
      "person_type": "Advogado",
      "side": "Active",
      "name": "Nome do Advogado",
      "tags": {
        "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee"
      }
    },
    {
      "person_type": "Advogado",
      "side": "Passive",
      "name": "Nome do Advogado",
      "tags": {
        "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee"
      }
    }
  ],
  "steps": [],
  "attachments": [],
  "related_lawsuits": [],
  "crawler": {
    "source_name": "JTJ - BR - Document / Lawsuit - Auth",
    "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee",
    "weight": 0,
    "updated_at": "2024-03-18T19:21:02.465Z"
  },
  "amount": 7685.82,
  "last_step": {
    "lawsuit_cnj": "0100248-39.2022.5.01.0037",
    "lawsuit_instance": 1,
    "step_id": "u2r/3iZieAWrkFjxBZC/r4bMlFAvRO1IWvaOD8xdGl8=",
    "step_date": "2024-03-18T19:21:02.465Z",
    "private": false,
    "steps_count": 1
  },
  "phase": "Inicial",
  "status": "Ativo",
  "name": "Autor X Réu"
},
{
  "code": "8888888-88.8888.8.88.8888",
  "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": "28e00227-e41b-4c94-956e-7a0f105eabee"
  },
  "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": "USUÁRIO TESTE",
      "side": "Active",
      "person_type": "Autor",
      "document": "88888888888",
      "document_type": "CPF",
      "lawyers": [],
      "tags": {
        "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee"
      }
    },
    {
      "name": "GABRIELLA",
      "side": "Active",
      "person_type": "Autor",
      "document": "88888888888",
      "document_type": "CPF",
      "lawyers": [],
      "tags": {
        "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee"
      }
    },
    {
      "name": "JULIANA",
      "side": "Active",
      "person_type": "Autor",
      "document": "88888888888",
      "document_type": "CPF",
      "lawyers": [],
      "tags": {
        "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee"
      }
    },
    {
      "name": "LEONARDO",
      "side": "Active",
      "person_type": "Autor",
      "document": "88888888888",
      "document_type": "CPF",
      "lawyers": [],
      "tags": {
        "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee"
      }
    },
    {
      "name": "LEONARDO2",
      "side": "Active",
      "person_type": "Autor",
      "document": "88888888888",
      "document_type": "CPF",
      "lawyers": [],
      "tags": {
        "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee"
      }
    },
    {
      "name": "LIVIA",
      "side": "Active",
      "person_type": "Autor",
      "document": "88888888888",
      "document_type": "CPF",
      "lawyers": [],
      "tags": {
        "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee"
      }
    },
    {
      "name": "LUCAS",
      "side": "Active",
      "person_type": "Autor",
      "document": "88888888888",
      "document_type": "CPF",
      "lawyers": [],
      "tags": {
        "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee"
      }
    },
    {
      "name": "MARCO",
      "side": "Active",
      "person_type": "Autor",
      "document": "88888888888",
      "document_type": "CPF",
      "lawyers": [],
      "tags": {
        "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee"
      }
    },
    {
      "name": "MARIA",
      "side": "Active",
      "person_type": "Autor",
      "document": "88888888888",
      "document_type": "CPF",
      "lawyers": [],
      "tags": {
        "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee"
      }
    },
    {
      "name": "SUELEN",
      "side": "Active",
      "person_type": "Autor",
      "document": "88888888888",
      "document_type": "CPF",
      "lawyers": [],
      "tags": {
        "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee"
      }
    },
    {
      "name": "GRUPO TURISMO LTDA",
      "side": "Passive",
      "person_type": "Réu",
      "lawyers": [],
      "tags": {
        "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee"
      }
    },
    {
      "name": "HOTEL LTDA",
      "side": "Passive",
      "person_type": "Réu",
      "lawyers": [],
      "tags": {
        "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee"
      }
    },
    {
      "name": "GRUPO TURISMO LTDA",
      "side": "Passive",
      "person_type": "Réu",
      "lawyers": [],
      "tags": {
        "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee"
      }
    },
    {
      "name": "GRUPO TURISMO LTDA",
      "side": "Passive",
      "person_type": "Réu",
      "lawyers": [],
      "tags": {
        "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee"
      }
    }
  ],
  "steps": [],
  "attachments": [],
  "related_lawsuits": [],
  "crawler": {
    "source_name": "JTJ - BR - Document / Lawsuit - Auth",
    "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee",
    "weight": 0,
    "updated_at": "2024-03-18T19:21:02.466Z"
  },
  "amount": 28790,
  "last_step": {
    "lawsuit_cnj": "0817064-37.2023.8.19.0209",
    "lawsuit_instance": 1,
    "step_id": "nU9IcVb9NLoHrJeUXt+Hay139dqHAVbfxk7f0D77aRQ=",
    "step_date": "2024-03-18T19:21:02.466Z",
    "private": false,
    "steps_count": 1
  },
  "phase": "Inicial",
  "status": "Ativo",
  "name": "DAVI LUIZ X GRUPO TURISMO LTDA"
},
{
  "code": "0824046-82.2023.8.19.0204",
  "justice": "8",
  "tribunal": "19",
  "instance": 1,
  "tribunal_acronym": "TJRJ",
  "secrecy_level": 0,
  "tags": {
    "is_fallback_source": true,
    "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee"
  },
  "subjects": [
    {
      "code": "7780",
      "name": "INDENIZAÇÃO POR DANO MATERIAL"
    },
    {
      "code": "7779",
      "name": "INDENIZAÇÃO POR DANO MORAL"
    }
  ],
  "classifications": [
    {
      "code": "436",
      "name": "PROCEDIMENTO DO JUIZADO ESPECIAL CÍVEL"
    }
  ],
  "courts": [
    {
      "code": "7869",
      "name": "BANGU REGIONAL XVII JUI ESP CIV"
    }
  ],
  "parties": [
    {
      "name": "FERNANDO",
      "side": "Active",
      "person_type": "Autor",
      "document": "72472723768",
      "document_type": "CPF",
      "lawyers": [],
      "tags": {
        "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee"
      }
    },
    {
      "name": "MARCO",
      "side": "Active",
      "person_type": "Autor",
      "document": "88888888888",
      "document_type": "CPF",
      "lawyers": [],
      "tags": {
        "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee"
      }
    },
    {
      "name": "SUELEN",
      "side": "Active",
      "person_type": "Autor",
      "document": "88888888888",
      "document_type": "CPF",
      "lawyers": [],
      "tags": {
        "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee"
      }
    },
    {
      "name": "SUELI",
      "side": "Active",
      "person_type": "Autor",
      "document": "88888888888",
      "document_type": "CPF",
      "lawyers": [],
      "tags": {
        "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee"
      }
    },
    {
      "name": "GRUPO TURISMO LTDA",
      "side": "Passive",
      "person_type": "Réu",
      "lawyers": [],
      "tags": {
        "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee"
      }
    },
    {
      "name": "HOTEL TURISMO LTDA",
      "side": "Passive",
      "person_type": "Réu",
      "lawyers": [],
      "tags": {
        "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee"
      }
    },
    {
      "name": "GRUPO TURISMO LTDA",
      "side": "Passive",
      "person_type": "Réu",
      "lawyers": [],
      "tags": {
        "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee"
      }
    },
    {
      "name": "GRUPO TURISMO LTDA",
      "side": "Passive",
      "person_type": "Réu",
      "lawyers": [],
      "tags": {
        "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee"
      }
    }
  ],
  "steps": [],
  "attachments": [],
  "related_lawsuits": [],
  "crawler": {
    "source_name": "JTJ - BR - Document / Lawsuit - Auth",
    "crawl_id": "28e00227-e41b-4c94-956e-7a0f105eabee",
    "weight": 0,
    "updated_at": "2024-03-18T19:21:02.466Z"
  },
  "amount": 46831,
  "last_step": {
    "lawsuit_cnj": "7777777-77.7777.7.77.7777",
    "lawsuit_instance": 1,
    "step_id": "YpIR5rAfSprFSseqRe9oVUPtkKcgQI0Na8RIv1djKZI=",
    "step_date": "2024-03-18T19:21:02.466Z",
    "private": false,
    "steps_count": 1
  },
  "phase": "Inicial",
  "status": "Ativo",
  "name": "FERNANDO X GRUPO TESTE"
}
]
}
2

Consultando a Existência de Processos para o Documento

Essa consulta retornará uma página por vez. Caso não seja necessário capturar os processos, a requisição pode ser realizada sem o objeto pagination. Nessa situação, os processos não serão retornados, sendo fornecida apenas a flag hasLawsuits, que indica se há ou não processos vinculados à consulta. Essa abordagem é comumente utilizada quando há a necessidade de tempos de resposta rápidos, como em rotinas de onboarding.

Exemplo de payload:

{
  "search": {
    "search_type": "cpf",
    "search_key": "999.999.999-99"
  }
}

Na consulta utilizando a flag hasLawsuits, não será possível aplicar filtros.

Resposta esperada:

{
  "has_lawsuits": true,
  "request_id": "bd2be78e-2d04-4fad-ad85-b6058e7cc4f4",
  "response_data": []
}
3

Consultando a quantidade de processos no datalake

É possivel consultar a quantidade de processos atrelados a um documento salvos em nosso datalake, para isso, basta realizar um requisição POST para o endpojnt https://lawsuits.prod.judit.io/requests/count adicionando search_type e search_key no payload.

curl --location 'https://lawsuits.prod.judit.io/requests/count' \
--header 'Content-Type: application/json' \
--header 'User-Agent: insomnia/8.5.1' \
--header 'api-key: <API-KEY>' \
--data '{
    "search": {
        "search_type": "cpf",
        "search_key": "999.999.999-99"
    }
}
'

Resposta esperada:

  {
  "total": 2
  }

Lembrando que com o request_id você pode consultar a resposta vinda dos tribunais da mesma forma que é feito na criação de requests padrão: https://docs.judit.io/api-reference/endpoint/requests/create