--- title: "DJEN Publications Search" method: POST path: "/br/djen/publications-search/v1" tags: ["Brazil", "Diário de Justiça Eletrônico Nacional (CNJ)"] --- # DJEN Publications Search `POST /br/djen/publications-search/v1` ## Request - Base URL: `https://api.croma.run` - URL: `https://api.croma.run/br/djen/publications-search/v1` - Auth: HTTP bearer Search Brazil's national court publications (Diário de Justiça Eletrônico Nacional, CNJ) by party name, lawyer name, OAB number, CNJ case number, court, free text and availability date: intimações, citações, editais and listas de distribuição from every state, federal, labour, electoral and military court and the superior courts, newest first, with the full text and the parties and lawyers each publication is addressed to. At least one of party, lawyer, OAB number, case number, court or text is required; `total` is exact for a single day and stops at 10,000 for a range. ## Headers - `Idempotency-Key` string ## Request body - object - `party_name` string: Nombre de una parte tal como aparece en la publicación, p. ej. `BANCO DO BRASIL` (opcional). Coincide por palabras completas, sin distinguir mayúsculas ni acentos. - `lawyer_name` string: Nombre de un abogado destinatario de la publicación (opcional). Coincide por palabras completas, sin distinguir mayúsculas ni acentos. - `oab_number` string: Número de inscripción en la OAB de un abogado destinatario, solo dígitos, p. ej. `123456` (opcional). - `oab_state` string: Sigla del estado (UF) de la inscripción en la OAB, p. ej. `SP` (opcional). - `registration_number` string: Número único del proceso (CNJ): 20 dígitos o con el formato NNNNNNN-DD.AAAA.J.TR.OOOO, p. ej. `0001234-56.2026.8.26.0100` (opcional). - `court_code` string: Sigla del tribunal en el DJEN, p. ej. `TJSP`, `TRT2`, `TRF1`, `STJ`, `TST`; los electorales llevan guion, `TRE-SP` (opcional). Sin distinguir mayúsculas. - `query` string: Texto a buscar en el cuerpo de la publicación (opcional). - `from_date` string, date: Optional date filter in yyyy-mm-dd format. - `to_date` string, date: Optional date filter in yyyy-mm-dd format. - `medium` 'any' | 'diario' | 'edital': `diario` para el Diário de Justiça Eletrônico Nacional, `edital` para la Plataforma Nacional de Editais, `any` para ambos. - `page` integer: 1-based page number for paginated results. - `per_page` integer: Resultados por página (6-50). ## Response `200` Successful response - DjenPublicationsSearchResponse - `data` DjenPublicationsSearchData, required - `total` integer, required: Publications matching the filters. Exact when `from_date` and `to_date` name the same day; for a wider range or no dates it stops at 10,000, see `total_is_lower_bound`. - `total_is_lower_bound` boolean, required: true when `total` is the 10,000 ceiling rather than the real count: more publications match than can be paged. Narrow the dates, or query one day at a time, which pages in full. - `count` integer, required: Publications in this response. - `page` integer, required: The page returned, echoed back. - `per_page` integer, required: Rows per page, echoed back. - `publications` object[], required: Newest availability date first; empty past the last page. - `id` integer, required: The DJEN's id for the publication. - `available_on` string, required: `yyyy-mm-dd` the publication became available (data de disponibilização). The publication date proper is the next business day and procedural deadlines start on the one after; this field is the availability date. - `court_code` string, required: The court's alias, e.g. `TJSP`, `TRT2`, `TRF1`, `STJ`. - `judicial_body` string, nullable, required: The judicial body (vara, turma, câmara) that issued it. - `judicial_body_id` integer, nullable, required: The DJEN's id for that judicial body. - `communication_type` string, nullable, required: `Intimação`, `Citação`, `Edital` or `Lista de distribuição`, as the court files it. - `document_type` string, nullable, required: The court's own label for the document, e.g. `Ato ordinatório`, `DESPACHO/DECISÃO`, `Edital`. - `medium` 'diario' | 'edital', nullable, required: `diario` for the Diário de Justiça Eletrônico Nacional, `edital` for the Plataforma Nacional de Editais. - `registration_number` string, nullable, required: The CNJ case number, 20 digits. - `registration_number_formatted` string, nullable, required: The same case number with the CNJ mask, `NNNNNNN-DD.AAAA.J.TR.OOOO`. - `class_name` string, nullable, required: Procedural class, e.g. `CUMPRIMENTO DE SENTENÇA`, `AÇÃO PENAL`. - `class_code` string, nullable, required: The CNJ code of the procedural class. - `sequence` integer, nullable, required: The court's sequence number for the publication. - `active` boolean, required: false when the court withdrew the publication. - `cancelled_on` string, nullable, required: When the court withdrew it, or null. - `cancellation_reason` string, nullable, required: Why the court withdrew it, or null. - `source_url` string, nullable, required: Link to the case in the court's own system, when the court provides one. - `text` string, required: The full text of the publication, as plain text with paragraph breaks. - `parties` object[], required: The parties the publication is addressed to, with their side. - `name` string, required: The party's name as the publication prints it. - `pole` string, nullable, required: Which side the party is on: `A` (polo ativo, the claimant side) or `P` (polo passivo, the defendant side); other letters as the court files them. - `lawyers` object[], required: The lawyers the publication is addressed to; empty on most editais. - `name` string, required: The lawyer's name as the publication prints it. - `oab_number` string, nullable, required: OAB registration number, digits only. - `oab_state` string, nullable, required: Two-letter state of the OAB registration, e.g. `SP`. - `checked_at` string, required: When this answer was read from the DJEN, as an ISO timestamp. ## Other responses - `400`: Invalid request body - `401`: Missing or invalid API key - `429`: Rate limit exceeded - `500`: Internal error - `502`: Upstream source returned an error --- [API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)