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.

🤖 The National Electronic Justice Gazette (DJEN) monitoring returns the communication object. Each object represents a DJEN publication that matched the monitored term. The root contains publication metadata (dates, court, type). Recipients are in the recipients array and their linked lawyers in recipient_lawyers.

General Structure

A communication JSON is organized into 4 main blocks:
  • Publication Metadata (root): Identification, dates, status, court and communication type.
  • Recipients (recipients): People directly mentioned in the publication — can be lawyers or non-lawyers (parties in the lawsuit).
  • Recipient Lawyers (recipient_lawyers): Lawyers linked to the parties, with OAB registration data.
  • Full Text (text): Complete content of the publication as extracted from the DJEN.

Data Dictionary

1. Publication Metadata (Object Root)

These properties appear directly at the root of the response_data object.

Required fields

PropertyTypeDescription
communication_idstringUnique identifier of the communication in the Judit system.
activebooleanIndicates whether the communication is active (true) or has been canceled (false).
date_availabilitystring (ISO 8601)Date when the publication became available in the DJEN.
date_shippingstring (ISO 8601)Dispatch/sending date of the communication by the court.
hashstringUnique publication hash, identifier from the DJEN.
lawsuit_codestringLinked lawsuit number in CNJ format (e.g., "0000000-00.0000.8.00.0000").
tribunal_acronymstringOfficial court acronym (e.g., "TJSP", "TJRJ", "TRT2").
statusstringPublication status in the DJEN (e.g., "P" for published).
textstringFull text of the publication as extracted from the National Electronic Justice Gazette.
sourcestringSource system of the publication (e.g., "pje", "esaj").

Optional fields

PropertyTypeDescription
classification_codestringProcedural class code associated with the communication.
classification_namestringProcedural class name (e.g., "ENFORCEMENT OF EXTRAJUDICIAL TITLE").
date_cancellationstring (ISO 8601)Cancellation date of the communication, when applicable.
reason_cancellationstringReason for the cancellation of the communication, when applicable.
api_idnumberInternal ID of the communication in the source system.
middlestringAbbreviated code of the publication vehicle (e.g., "D" for DJEN).
full_middlestringFull name of the publication vehicle (e.g., "NATIONAL ELECTRONIC JUSTICE GAZETTE").
name_organstringName of the court organ responsible for the publication (e.g., "1st CIVIL COURT").
communication_numbernumberSequential number of the communication within the DJEN edition.
communication_typestringCommunication type (e.g., "INTIMATION", "SUMMONS").
document_typestringType of published document (e.g., "DECISION", "ORDER", "JUDGMENT").
integrate_apibooleanIndicates whether the communication was integrated via an external API.

2. Recipients (recipients)

Array with the people directly mentioned in the publication — can be lawyers or non-lawyers (parties in the lawsuit). All fields are required.
PropertyTypeDescription
communication_idnumberInternal ID of the communication the recipient is linked to.
namestringFull name of the recipient as it appears in the publication.
sidestringParty side in the lawsuit: "Active" or "Passive".

3. Recipient Lawyers (recipient_lawyers)

Array with the lawyers linked to the communication recipients. All fields are required.
PropertyTypeDescription
idnumberUnique identifier of the lawyer-communication link.
lawyer_idnumberLawyer ID (reference to the lawyer object).
communication_idnumberInternal communication ID the lawyer is linked to.
created_atstringCreation date of the link record.
updated_atstringLast update date of the link record.

Nested lawyer object

PropertyTypeDescription
idnumberUnique lawyer identifier in the system.
namestringLawyer’s full name.
license_codestringOAB registration number.
license_statestringOAB state section (e.g., "SP", "RJ").

Payload Example (Communication)

{
  "page": 1,
  "page_count": 1,
  "all_count": 1,
  "all_pages_count": 1,
  "page_data": [
    {
      "request_id": "186e0ed5-4656-4fd8-8e07-76f755c44a9d",
      "response_id": "dd47b9fc-8f66-46b8-a31a-50a4718c9774",
      "origin": "tracking",
      "origin_id": "a94db796-9e35-4d0c-8e05-2a6b60f32a74",
      "response_type": "communication",
      "response_data": {
        "communication_id": "0E6hgZvG",
        "active": true,
        "classification_code": "12154",
        "classification_name": "ENFORCEMENT OF EXTRAJUDICIAL TITLE",
        "date_availability": "2026-05-20T00:00:00.000Z",
        "date_shipping": "2026-05-19T03:00:00.000Z",
        "recipient_lawyers": [
          {
            "lawyer": {
              "id": 10001,
              "name": "EXAMPLE LAWYER 1",
              "license_code": "0001",
              "license_state": "SP"
            },
            "lawyer_id": 10001,
            "communication_id": 600000001,
            "id": 1100000001,
            "created_at": "2026-05-19 11:44:08",
            "updated_at": "2026-05-19 11:44:08"
          }
        ],
        "recipients": [
          {
            "communication_id": 600000001,
            "name": "ACTIVE PARTY EXAMPLE",
            "side": "Active"
          },
          {
            "communication_id": 600000001,
            "name": "PASSIVE PARTY EXAMPLE 1",
            "side": "Passive"
          }
        ],
        "hash": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "api_id": 600000001,
        "middle": "D",
        "full_middle": "NATIONAL ELECTRONIC JUSTICE GAZETTE",
        "name_organ": "DISTRICT COURT - 1st CIVIL COURT",
        "communication_number": 2674,
        "lawsuit_code": "0000000-00.0000.8.00.0000",
        "tribunal_acronym": "TJXX",
        "status": "P",
        "text": "Full text of the publication as extracted from the DJEN...",
        "communication_type": "INTIMATION",
        "document_type": "DECISION",
        "integrate_api": false,
        "source": "pje"
      },
      "user_id": "00000000-0000-0000-0000-000000000000",
      "created_at": "2026-05-20T20:12:47.839Z",
      "updated_at": "2026-05-20T20:12:47.839Z"
    }
  ]
}

Next Steps