> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.
# DJEN
> Brazil's national court publications: search every intimação, citação and edital the courts publish through the CNJ's Diário de Justiça Eletrônico Nacional by party, lawyer, OAB number, case number, court, text and date, with the full text.
Every publication the Brazilian courts issue through the Conselho Nacional
de Justiça's national platform: intimações, citações, editais and listas de
distribuição from the state, federal, labour, electoral and military courts
and from the superior courts (STJ, TST, STM, TSE), with the full text, the
judicial body, the CNJ case number and the parties and lawyers each one is
addressed to. Coverage starts in 2020 and grows court by court: the federal
courts from late 2020, TJMG from 2023, TJRJ, TRT2 and STJ from 2024 and TJSP
from April 2025. STF publishes its own diário and is not included.
One search, filtered by party name, lawyer name or OAB number, case number,
court, free text and availability date, newest first. At least one of party,
lawyer, OAB number, case number, court or text is required.
`POST /br/djen/publications-search/v1`
At least one of `party_name`, `lawyer_name`, `oab_number`, `registration_number`,
`court_code` or `query` is required.
| Field | Type | Notes |
| --------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `party_name` | string | A party's name as printed on the publication, e.g. `BANCO DO BRASIL`. Whole words, any case or accents; send the bare name without `S.A.`. |
| `lawyer_name` | string | A lawyer's name as printed on the publication. Same matching as `party_name`. |
| `oab_number` | string | OAB registration number, digits only, e.g. `123456`. Works alone; add `oab_state` to narrow it. |
| `oab_state` | string | Two-letter state of the OAB registration, e.g. `SP`. |
| `registration_number` | string | The CNJ case number: 20 digits or the mask `NNNNNNN-DD.AAAA.J.TR.OOOO`, e.g. `0001234-56.2026.8.26.0100`. |
| `court_code` | string | Court alias, e.g. `TJSP`, `TRT2`, `TRF1`, `STJ`, `TST`; electoral courts are hyphenated, `TRE-SP`. Any case. The full list is at the end of this page. |
| `query` | string | Free text matched against the body of the publication. |
| `from_date` | string | First availability date, `yyyy-mm-dd`. Empty means no lower bound. |
| `to_date` | string | Last availability date, `yyyy-mm-dd`. Equal to `from_date` for one day, which counts and pages in full. |
| `medium` | enum | `diario` (Diário de Justiça Eletrônico Nacional), `edital` (Plataforma Nacional de Editais) or `any`. Default `any`. |
| `page` | integer | 1-based page. Default `1`. |
| `per_page` | integer | 6-50. Default `20`. |
```bash theme={"dark"}
curl https://api.croma.run/br/djen/publications-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"party_name": "BANCO DO BRASIL",
"court_code": "TJSP",
"from_date": "2026-09-09",
"to_date": "2026-09-09",
"per_page": 10
}'
```
Returns `total`, `total_is_lower_bound`, `count`, `page`, `per_page`, `publications[]` (newest availability date first) and `checked_at`.
| Field | Notes |
| -------------------------- | ---------------------------------------------------------------------------------- |
| `id` | The DJEN's id for the publication. |
| `available_on` | `yyyy-mm-dd` the publication became available (data de disponibilização). |
| `court_code` | Court alias, e.g. `TJSP`. |
| `judicial_body` | The vara, turma or câmara that issued it. |
| `communication_type` | `Intimação`, `Citação`, `Edital` or `Lista de distribuição`. |
| `document_type` | The court's own label, e.g. `Ato ordinatório`, `DESPACHO/DECISÃO`. |
| `medium` | `diario` or `edital`. |
| `registration_number` | The CNJ case number, 20 digits; `registration_number_formatted` carries the mask. |
| `class_name`, `class_code` | Procedural class and its CNJ code. |
| `source_url` | Link to the case in the court's own system, when the court provides one. |
| `text` | The full text of the publication, as plain text. |
| `parties[]` | `{ name, pole }`, `pole` `A` for the claimant side and `P` for the defendant side. |
| `lawyers[]` | `{ name, oab_number, oab_state }`; empty on most editais. |
`total` is exact when `from_date` and `to_date` name the same day. For a
wider range, or no dates, the DJEN stops counting and paging at 10,000
publications: `total_is_lower_bound` is then `true`, and a page past that
window is refused with HTTP 400. To read everything about a busy name,
query one day at a time.
`available_on` is the date the publication became available. Under the
Brazilian Code of Civil Procedure the publication date is the next business
day and procedural deadlines start on the business day after that; count
them from `available_on` with a court calendar, not with plain day arithmetic.
Court codes accepted by `court_code`: `CJF`, `CNJ`, `PJeCor`, `SEEU`, `STJ`, `STM`, `TJAC`, `TJAL`, `TJAM`, `TJAP`, `TJBA`, `TJCE`, `TJDFT`, `TJES`, `TJGO`, `TJMA`, `TJMG`, `TJMMG`, `TJMRS`, `TJMS`, `TJMSP`, `TJMT`, `TJPA`, `TJPB`, `TJPE`, `TJPI`, `TJPR`, `TJRJ`, `TJRN`, `TJRO`, `TJRR`, `TJRS`, `TJSC`, `TJSE`, `TJSP`, `TJTO`, `TRE-AC`, `TRE-AL`, `TRE-AM`, `TRE-AP`, `TRE-BA`, `TRE-CE`, `TRE-DF`, `TRE-ES`, `TRE-GO`, `TRE-MA`, `TRE-MG`, `TRE-MS`, `TRE-MT`, `TRE-PA`, `TRE-PE`, `TRE-PI`, `TRE-PR`, `TRE-RJ`, `TRE-RN`, `TRE-RO`, `TRE-RS`, `TRE-SC`, `TRE-SE`, `TRE-SP`, `TRE-TO`, `TRF1`, `TRF2`, `TRF3`, `TRF4`, `TRF5`, `TRF6`, `TRT1`, `TRT2`, `TRT3`, `TRT4`, `TRT5`, `TRT6`, `TRT7`, `TRT8`, `TRT9`, `TRT10`, `TRT11`, `TRT12`, `TRT13`, `TRT14`, `TRT15`, `TRT16`, `TRT17`, `TRT18`, `TRT19`, `TRT20`, `TRT21`, `TRT22`, `TRT23`, `TRT24`, `TSE`, `TST`.
Schemas, all response fields, and an interactive playground.