1

Criação de Request

Para consultar dados cadastrais via CPF, CNPJ ou Nome, a requisição deve ser realizada através do endpoint /requests/create da API de lawsuits. A consulta por dados cadastrais pode ser realizada diretamente em nosso datalake ou em tempo real na receita federal, para que sejam consultados os dados em tempo real, basta adicionar o parâmentro on-demand com o valor true no payload da requisção.
Na consulta por dados cadastrais, o search_type deve ser ‘cpf’, ‘cnpj’ ou ‘name’, já o campo response_type deverá sempre ser ‘entity’.
Exemplo de Consulta por CPF:
curl --location '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",
         "response_type": "entity"
     }
 }'
Exemplo de Consulta por CNPJ:
curl --location 'https://lawsuits.prod.judit.io/requests/create' \
--header 'Content-Type: application/json' \
--header 'api-key: <API-KEY>' \
--data '{
    "search": {
        "search_type": "cnpj",
        "search_key": "99.999.999/9999-99",
        "response_type": "entity"
    }
}'
Exemplo de Consulta por Nome:
Ao realizar consultas por nome na busca de dados cadastrais, é possível que existam homônimos (pessoas ou empresas com o mesmo nome). Recomendamos que, sempre que possível, utilize identificadores únicos, como CPF ou CNPJ, para garantir maior precisão nos resultados.
curl --location 'https://lawsuits.prod.judit.io/requests/create' \
 --header 'Content-Type: application/json' \
 --header 'api-key: <API-KEY>' \
 --data '{
     "search": {
         "search_type": "name",
         "search_key": "Nome teste",
         "response_type": "entity"
     }
 }'
Ao realizar uma consulta por CNPJ, é possível obter informações detalhadas, incluindo dados não mascarados dos sócios associados ao CNPJ consultado. Para acessar essas informações, basta incluir a propriedade reveal_partners_documents e definir seu valor como true.
Resposta por CPF
{
   "has_lawsuits": false,
   "request_id": "5c618521-2ecc-4176-a573-431d2e0edeb2",
   "response_data": [
       {
           "entity_id": "",
           "entity_type": "person",
           "main_document": "999.999.999-99",
           "name": "JOÃO TESTE",
           "addresses": [
               {
                   "street": "RUA RAMOS DE CARVALHO",
                   "number": "999",
                   "complement": "",
                   "neighborhood": "CENTRO",
                   "city": "RIO DE JANEIRO",
                   "state": "RJ",
                   "country": "Brasil",
                   "zip_code": "99999999",
                   "ibge_code": 9999999
               }
           ],
           "aka_names": [],
           "contacts": [
               {
                   "description": "21999999999",
                   "contact_type": "phone"
               }
           ],
           "documents": [],
           "parents": [
               {
                   "name": "JANAINA DA SILVA",
                   "kinship": "mother"
               }
           ],
           "partners": [],
           "associated_people": [],
           "tags": {
               "revenue_update_date": "2022-05-30T00:00:00.000Z"
           },
           "created_at": "2024-10-12T13:28:59.051Z",
           "updated_at": "2024-10-12T13:28:59.051Z",
           "nationality": "BRASILEIRA",
           "birth_date": "1981-08-07T00:00:00.000Z",
           "gender": "male",
           "revenue_service_active": true
       }
   ]
}
Resposta por CNPJ
{
   "has_lawsuits": false,
   "request_id": "6e5a24f7-f874-4234-8acc-419142e2b066",
   "response_data": [
       {
           "entity_id": "",
           "entity_type": "company",
           "main_document": "99.999.999/0009-99",
           "name": "FINGI - EM RECUPERACAO JUDICIAL",
           "social_name": "FING",
           "addresses": [
               {
                   "street": "RUA DO JOÃO CIRILO",
                   "number": "99",
                   "complement": "ANDAR 9",
                   "neighborhood": "CENTRO",
                   "city": "RIO DE JANEIRO",
                   "state": "RJ",
                   "country": "BRASIL",
                   "zip_code": "99999999",
                   "ibge_code": 999999
               }
           ],
           "aka_names": [],
           "contacts": [
               {
                   "description": "999999999",
                   "contact_type": "phone"
               },
               {
                   "description": "999999999",
                   "contact_type": "phone"
               },
               {
                   "description": "ouvidoria@fing.com.br",
                   "contact_type": "email"
               }
           ],
           "documents": [],
           "parents": [],
           "partners": [
               {
                   "entity_id": "",
                   "entity_type": "company",
                   "main_document": "***999999**",
                   "name": "JOÃO DE OLIVEIRA SOUZA",
                   "position": "CONSELHEIRO DE ADMINISTRAÇÃO",
                   "addresses": [],
                   "aka_names": [],
                   "contacts": [],
                   "documents": [],
                   "parents": [],
                   "partners": [],
                   "branch_activities": [],
                   "associated_people": [],
                   "tags": {
                       "age_group": "Entre 61 a 70 anos",
                       "start_date": "2018-09-25T00:00:00.000Z"
                   },
                   "created_at": "2024-10-12T13:32:25.135Z",
                   "updated_at": "2024-10-12T13:32:25.135Z"
               }
           ],
           "branch_activities": [
               {
                   "code": "9999999",
                   "name": "SERVIÇOS DE ATENDIMENTO AO CLIENTE - SAC",
                   "active": true,
                   "main_activity": true,
                   "tree_history": ""
               },
               {
                   "code": "9999999",
                   "name": "CONSTRUÇÃO DE ESTAÇÕES E REDES",
                   "active": true,
                   "main_activity": false,
                   "tree_history": ""
               }
           ],
           "associated_people": [],
           "tags": {
               "revenue_update_date": "2005-11-03T00:00:00.000Z"
           },
           "created_at": "2024-10-12T13:32:25.134Z",
           "updated_at": "2024-10-12T13:32:25.134Z",
           "nationality": "BRASILEIRA",
           "birth_date": "1966-09-26T00:00:00.000Z",
           "size": "DEMAIS",
           "legal_nature": {
               "code": "2046",
               "name": "SOCIEDADE ANÔNIMA ABERTA",
               "active": true
           },
           "head_office": true,
           "revenue_service_active": true,
           "special_status": "RECUPERACAO JUDICIAL",
           "special_status_date": "2016-06-29T00:00:00.000Z",
           "share_capital": 99999999999
       }
   ]
}
Resposta por Nome
{
   "request_id": "223458ec-f3a1-4851-8d2b-19672066565c",
   "response_data": [
       {
           "entity_id": "999.999.999-99",
           "entity_type": "person",
           "main_document": "999.999.999-99",
           "name": "Usuário Teste",
           "addresses": [],
           "aka_names": [],
           "contacts": [],
           "documents": [],
           "parents": [
               {
                   "name": "Usuário teste 1",
                   "kinship": "mother"
               }
           ],
           "partners": [],
           "associated_people": [],
           "tags": {},
           "created_at": "2025-04-19T00:14:56.561Z",
           "updated_at": "2025-04-19T00:14:56.561Z",
           "nationality": "BRASILEIRA",
           "birth_date": "1989-12-25T00:00:00.000Z",
           "gender": "male"
       }
   ]
}
Ao realizar uma consulta por CNPJ, é possível obter informações detalhadas, incluindo dados não mascarados dos sócios associados ao CNPJ consultado. Para acessar essas informações, basta incluir a propriedade reveal_partners_documents e definir seu valor como true.
O significado de cada campo pode ser encontrado no glossário:https://docs.judit.io/essentials/glossary