Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.judit.io/llms.txt

Use this file to discover all available pages before exploring further.

New CNPJ format (IN 2229/24)Judit already accepts the new alphanumeric CNPJ format in compliance with the Brazilian Federal Revenue Normative Instruction No. 2229/2024.
  • Zero effort: no changes are required in your integration.
  • Test environment: use the document A1B2C3D4/E5F6-68 to validate the flow and receive a mock lawsuit in response.
The Registration Data Query returns identity information for an individual or company: name/corporate name, registration status, addresses, contacts, partners and relationships. The whole call is synchronous and can read from Judit’s datalake (fast and cheap) or directly from the Brazilian Federal Revenue in real time (on_demand: true).
🤖 Endpoint: POST https://lawsuits.production.judit.io/entities. search_type accepts cpf, cnpj or name. response_type is always entity. For real-time response (Receita Federal), send on_demand: true in the payload.

​
When to use

Onboarding and KYC

Validate name, registration status and address during customer onboarding without extra friction.

Database enrichment

Update CRM/ERP records with consolidated data by CPF/CNPJ.

Anti-fraud

Cross-check user-supplied data against the official source in seconds.

Corporate group mapping

Use the response to discover branches and corporate relationships linked to a CNPJ.

​
Datalake vs. On-Demand (Federal Revenue)

TraitDatalake (default)On-Demand (on_demand: true)
Latencymsseconds
SourceJudit cacheBrazilian Federal Revenue (live)
FreshnessLast Judit collectionCurrent Receita state
CostLowerHigher
Best forFast onboarding, mass enrichmentCritical compliance, high-risk decisions

​
Step 1: Create the query (POST)

POST https://lawsuits.production.judit.io/entities

​
Examples by document type

{
    "search": {
        "search_type": "cpf",
        "search_key": "999.999.999-99",
        "response_type": "entity"
    }
}
For name queries, homonyms are possible. Whenever possible, prefer CPF or CNPJ for accuracy.

​
Payload parameters

ParameterTypeRequiredDescription
search.search_typestringYes"cpf", "cnpj" or "name".
search.search_keystringYesDocument or name to search.
search.response_typestringYesAlways "entity".
search.on_demandbooleanNoIf true, forces a live read from the Brazilian Federal Revenue.
search.reveal_partners_documentsbooleanNo(CNPJ) Returns unmasked partner documents.

​
Request example (POST)

curl --location 'https://lawsuits.production.judit.io/entities' \
  --header 'api-key: '"$JUDIT_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "search": {
      "search_type": "cpf",
      "search_key": "999.999.999-99",
      "response_type": "entity"
    }
  }'

​
Step 2: Read the response

The response comes in the same POST body. Main fields:
FieldTypeDescription
request_idstringUnique query identifier.
response_dataarrayList of found entities (follows the Entity Schema).
response_data[].entity_typestring"person" (PF) or "company" (PJ).
response_data[].main_documentstringCPF or CNPJ.
response_data[].addressesarrayAssociated addresses.
response_data[].contactsarrayPhones and emails.
response_data[].partnersarray(PJ) Partners and administrators.

​
Response examples

{
    "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",
                    "neighborhood": "CENTRO",
                    "city": "RIO DE JANEIRO",
                    "state": "RJ",
                    "country": "Brasil",
                    "zip_code": "99999999"
                }
            ],
            "contacts": [
                { "description": "21999999999", "contact_type": "phone" }
            ],
            "parents": [
                { "name": "JANAINA DA SILVA", "kinship": "mother" }
            ],
            "tags": { "revenue_update_date": "2022-05-30T00:00:00.000Z" },
            "nationality": "BRASILEIRA",
            "birth_date": "1981-08-07T00:00:00.000Z",
            "gender": "male",
            "revenue_service_active": true,
            "created_at": "2024-10-12T13:28:59.051Z",
            "updated_at": "2024-10-12T13:28:59.051Z"
        }
    ]
}
Full structure of each item: see Entity Schema. Field glossary: Glossary.
When querying by CNPJ with reveal_partners_documents: true, partner CPFs/CNPJs are returned without masking. Only use it when you have a clear legal basis (KYC, AML, due diligence) — and never persist the unmasked values longer than necessary.