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.

🤖 Registration data queries return a common base object called entity. Depending on whether the query was made by CPF or CNPJ, the entity_type property will return "person" or "company", respectively. Some fields, such as parents (parentage) or share_capital, are exclusive to their respective entity type.

​
Base structure (common to CPF and CNPJ)

Whenever you query a valid document, the Judit API returns the entity block containing the following universal properties:

​
Main identification

PropertyTypeDescription
entity_idstringUnique internal identifier for the entity in Judit’s system.
entity_typestringEntity type: "person" (natural person) or "company" (legal entity).
main_documentstringPrimary document (CPF or CNPJ). Returned as digits only.
namestringFull civil name of the person or official corporate name of the company.
aka_namesarrayList of alternative names (nicknames, maiden names, or trade names).
nationalitystringNationality of the person or country of registration of the company.
revenue_service_activebooleanIndicates whether the document is active and in good standing with the Brazilian Federal Revenue (Receita Federal).
created_at / updated_atstringISO 8601 dates of record creation and last update in the system.
tagsobjectAdditional metadata or crawler control data (e.g., extraction date from Receita Federal).

​
Contact and location arrays

All entities (persons or companies) have standardized arrays for contacts and addresses.

​
Addresses (addresses)

List of residential or commercial addresses linked to the document.
PropertyTypeDescription
streetstringMain street name (Rua, Avenida, etc.).
numberstringBuilding number.
complementstringAddress complement (apartment, block, suite, floor).
neighborhoodstringNeighborhood.
citystringCity.
statestringBrazilian state abbreviation (e.g., "SP", "RJ").
countrystringCountry.
zip_codestringPostal code (CEP). Returned as digits only.
ibge_codenumberOfficial IBGE municipality code.

​
Contacts (contacts)

List of communication channels extracted from the data sources.
PropertyTypeDescription
contact_typestringContact category (e.g., "phone", "email").
descriptionstringThe contact value itself (phone number or email address).

​
Other documents (documents)

List of secondary identification documents (such as RG, CNH, or state registration — IE).
PropertyTypeDescription
document_typestringType of secondary document (e.g., "RG", "IE").
documentstringDocument number without formatting.

​
👤 Exclusive properties: Natural person (person)

If the query is for a CPF (entity_type: "person"), the object may contain the following additional properties and arrays:
PropertyTypeDescription
birth_datestringDate of birth. ISO 8601 format.
genderstringRegistered gender (e.g., "M", "F").
parentsarrayParentage array. Each item contains name (full name) and kinship (degree of kinship, e.g., "mother", "father").
partnersarrayList of identified spouses or domestic partners.
associated_peoplearrayList of other natural persons with identifiable relationships (business ties, shared residence).

​
🏢 Exclusive properties: Company (company)

If the query is for a CNPJ (entity_type: "company"), the object may contain the following corporate and operational fields:

​
Operational data

PropertyTypeDescription
social_namestringTrade name (company’s market-facing name).
birth_datestringOfficial date of incorporation registered with Receita Federal.
sizestringOfficial company size classification (e.g., "ME", "EPP", "DEMAIS").
head_officebooleanIndicates whether this CNPJ is the head office (true) or a branch (false).
special_statusstringSpecial tax status (e.g., judicial reorganization, composition with creditors).
share_capitalnumberDeclared share capital value, numeric.
parentsarrayList of companies acting as parent, controlling, or holding entities (economic group).

​
Corporate and economic structure

PropertyTypeDescription
codestringOfficial numeric code of the legal nature (e.g., "206-2").
namestringFull description (e.g., "Sociedade Empresária Limitada").
activebooleanIndicates whether this is the currently active classification.

​
Shareholders and administrators — QSA (partners)

PropertyTypeDescription
namestringName of the partner or administrator.
main_documentstringCPF or CNPJ of the corporate participant.
positionstringQualification / role held (e.g., "SÓCIO-ADMINISTRADOR", "DIRETOR").
entity_typestringType of the partner entity ("person" or "company").

​
Economic activities — CNAE (branch_activities)

PropertyTypeDescription
codestringCNAE code of the activity.
namestringFull title or description of the activity.
main_activitybooleanIndicates whether this is the primary CNAE (true) or a secondary CNAE (false).

​
Example payload (Natural person)

{
    "has_lawsuits": false,
    "request_id": "00000000-0000-0000-0000-000000000001",
    "response_data": [
        {
            "entity_id": "",
            "entity_type": "person",
            "main_document": "99999999999",
            "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": "MARIA TESTE",
                    "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
        }
    ]
}

​
Next steps

Now that you understand the registration data dictionary, see how to query this information:
  • 👉 Registration data queries: See the documentation for the request route to fetch and enrich CPFs and CNPJs in real time.