Brazil DataJud Court Case Metadata

Search public Brazilian court metadata across multiple tribunals in one run. Filter by CNJ case numbers, class and subject codes, or filing dates. Export consistent English fields with original Portuguese code labels, source links, and optional latest movements.

Use this Actor only for lawful KYC, credit and legal research under Brazil's LGPD. You are responsible for establishing and documenting your own legal basis, purpose, necessity, retention period and access controls. Public availability alone does not establish a legal basis. Do not use this Actor to profile individuals or make automated adverse decisions about them. Case metadata is not evidence of liability, guilt or creditworthiness. Seek qualified legal advice for your intended processing.

Quick start

{"tribunals":["TRT1","TRF1","TJSP"],"maxResults":20}

The default searches three tribunal indices and returns up to 20 records. Tribunals are visited in turn, each with its own pagination cursor. Results are ordered by source update timestamp within each tribunal, oldest first; the combined output has no global ordering. A cap can leave some tribunals unvisited. This is a metadata snapshot, not a complete judicial background check.

Inputs

Input	Default	Meaning
tribunals	["TRT1","TRF1","TJSP"]	Official tribunal codes; ["all"] expands the selected group.
tribunalGroup	TRT	TJ state and state military, TRF federal, TRT labour, or TRE electoral; used only for all.
caseNumbers	[]	Up to 100 formatted or bare 20-digit CNJ case numbers.
classCodes	[]	Numeric TPU class codes.
subjectCodes	[]	Numeric TPU subject codes.
filingDateFrom, filingDateTo	omitted	Inclusive YYYY-MM-DD filing date range.
maxResults	20	Global cap, 1–10,000 records.
includeMovements	false	Add latest public movement date/code/name triples.
latestMovements	5	Movement limit per row, 1–100.
apiKey	resolved at runtime	Optional public-key override. Otherwise DATAJUD_API_KEY, then the current key on CNJ's official access wiki.

Values within a code list match any value; different filters are combined. Case-number searches derive their tribunal indices from the CNJ J.TR segment, overriding the tribunal selection. Filing-date filters include both ISO dates and compact CNJ timestamps, with inclusive calendar-day bounds. For a federal search, use {"tribunals":["all"],"tribunalGroup":"TRF","maxResults":100}. Supported tribunal codes come from CNJ's published catalogue (91 endpoints at capture); a renamed or newly added index requires a catalogue update.

Output

One row represents a source case record. The same CNJ case can appear in several degrees or courts; rows are deduplicated by source index and record ID.

Fields: caseId, caseNumber, tribunal, court, class, subjects, filingDate, filingDateRaw, lastUpdate, degree, system, format, movementCount, latestMovements, sourceIndex, sourceUrl, scrapedAt. Court, class, subjects, system and format carry code and name. Latest movements carry code, name and date; the array is empty when disabled. The source URL is the official search API and requires a POST query to reproduce the row, rather than opening a case detail page.

Dates use ISO 8601. Compact source filing dates have no published timezone and remain without an offset; filingDateRaw preserves the original value. scrapedAt is UTC retrieval time and does not establish source freshness. CNJ records can lag court systems; sealed cases and unpublished information are outside coverage. No party names, movement complements or external personal-data enrichment are included.

Reliability and limits

The Actor delivers each page as it arrives. It retries temporary failures, respects server retry waits, confirms empty pages with a new session and reserves time to save results. If some tribunals fail after rows were delivered, the run succeeds with an incomplete-query status naming those tribunals. Zero delivered rows fails plainly, including a genuinely empty search; inspect the status. A reached row cap is a partial search, not an assertion of full coverage. Pagination uses timestamp and record ID, stops on repeated cursors, and rejects partial-shard pages. Changes to a live index during traversal may still affect coverage; the API does not provide a snapshot guarantee in this Actor.

Example public metadata row from the local validation run:

{
  "caseId": "TRT1_G2_01016068820245010483",
  "caseNumber": "0101606-88.2024.5.01.0483",
  "tribunal": "TRT1",
  "court": {
    "code": 82967,
    "name": "Gabinete 52"
  },
  "class": {
    "code": 1009,
    "name": "Recurso Ordinário Trabalhista"
  },
  "subjects": [
    {
      "code": 13769,
      "name": "Horas Extras"
    },
    {
      "code": 13771,
      "name": "intervalo Interjonadas"
    },
    {
      "code": 13772,
      "name": "Intervalo Intrajornada"
    },
    {
      "code": 13773,
      "name": "Repouso Semanal Remunerado e Feriado"
    },
    {
      "code": 13787,
      "name": "Adicional de Horas Extras"
    },
    {
      "code": 13790,
      "name": "Comissionista"
    },
    {
      "code": 13799,
      "name": "Adicional de Hora Extra"
    },
    {
      "code": 13839,
      "name": "Comissões e Percentuais"
    },
    {
      "code": 13851,
      "name": "Participação nos Lucros e Resultados - PLR"
    }
  ],
  "filingDate": "2026-03-11T08:40:44",
  "filingDateRaw": "20260311084044",
  "lastUpdate": "2026-07-07T02:04:01.848000Z",
  "degree": "G2",
  "system": {
    "code": 1,
    "name": "PJe"
  },
  "format": {
    "code": 1,
    "name": "Eletrônico"
  },
  "movementCount": 6,
  "latestMovements": [],
  "sourceIndex": "api_publica_trt1",
  "sourceUrl": "https://api-publica.datajud.cnj.jus.br/api_publica_trt1/_search",
  "scrapedAt": "2026-11-01T00:48:14.166153Z"
}