DGSI - Portuguese Case Law Search avatar

DGSI - Portuguese Case Law Search

Pricing

from $1.00 / 1,000 results

Go to Apify Store
DGSI - Portuguese Case Law Search

DGSI - Portuguese Case Law Search

Search Portuguese case law (STJ, STA, Courts of Appeal, TCA, Tribunal dos Conflitos) in the official DGSI databases: headnotes (sumário), descriptors, outcome and full text.

Pricing

from $1.00 / 1,000 results

Rating

0.0

(0)

Developer

Miguel González

Miguel González

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

14 days ago

Last modified

Categories

Features

Limited permissions

Share

Searches court decisions (acórdãos) in the official DGSI databases of the Portuguese Ministry of Justice: Supremo Tribunal de Justiça (STJ), Supremo Tribunal Administrativo (STA), Tribunal dos Conflitos, the five Courts of Appeal (Relações of Porto, Lisboa, Coimbra, Guimarães and Évora), the two Central Administrative Courts (TCA Sul and Norte) and the Constitutional Court up to 1998. Supports full-text search with AND/OR/NOT, exact phrases and the * wildcard (Spanish and Portuguese operators Y/E, O/OU, NO/NÃO are translated automatically), filters by court, reporting judge (relator), subject descriptor and decision date range, and sorting by relevance or date added. For each decision it returns case number, reporting judge, descriptors, decision date, vote, procedural type, outcome, the official headnote (sumário) and, optionally, the full text. A second run can fetch specific decisions by URL (documentUrls). Limits: DGSI returns at most 1,000 hits per query and court; maxResults is the total per search term (when several courts are searched, results alternate between courts in hierarchical order, or are merged by date).

Use cases

  • Find Supreme Court (STJ) or Court of Appeal case law on a legal issue (e.g. culpable insolvency) within a date range.
  • List decisions by a given reporting judge or with a given subject descriptor.
  • Compare how different Courts of Appeal decide the same issue.
  • Extract official headnotes (sumários) for quick review or LLM analysis.
  • Download the full text of specific decisions from their URLs (documentUrls).

How to use (guide for AI agents)

  • databases: opaque codes (jstj, jsta, jtrp…) — pick by their title. Empty = all courts (slower).
  • searchTerms: one search per item, written in Portuguese. Use AND between concepts and quotes for phrases: "insolvência culposa" AND gerente.
  • Dates use YYYY-MM-DD (dateFrom, dateTo).
  • To read full decisions: search first, then pass the returned documentUrl values in documentUrls with includeFullText: true.
  • Every result includes searchTerm and rank; passages holds the paragraphs where the search terms appear, ready for LLM analysis.

Coverage

CodeCourt
jstjSupremo Tribunal de Justiça
jstaSupremo Tribunal Administrativo
jconTribunal dos Conflitos
jtrp / jtrl / jtrc / jtrg / jtreCourts of Appeal (Porto, Lisboa, Coimbra, Guimarães, Évora)
jtca / jtcnCentral Administrative Courts (South / North)
atco1Constitutional Court (until 1998); for current case law use legaltech/tribunal-constitucional-pt

Input example

{
"searchTerms": ["\"insolvência culposa\" OU (falência E dolo)"],
"databases": ["jstj", "jtrp"],
"dateFrom": "2022-01-01",
"dateTo": "2023-12-31",
"maxResults": 20,
"includeFullText": false
}

Output example (abridged)

{
"searchTerm": "\"insolvência culposa\" OU (falência E dolo)",
"database": "jtrp",
"court": "Tribunal da Relação do Porto",
"rank": 1,
"relevance": "93%",
"processNumber": "8053/21.1T8PRT.P1",
"relator": "FILIPE CAROÇO",
"descriptors": ["ENCERRAMENTO DO PROCESSO DE INSOLVÊNCIA", "EXONERAÇÃO DO PASSIVO RESTANTE"],
"documentNumber": "RP202211108053/21.1T8PRT.P1",
"decisionDate": "11/10/2022",
"decisionDateISO": "2022-11-10",
"vote": "UNANIMIDADE",
"proceduralMeans": "APELAÇÃO",
"decision": "CONFIRMADA",
"summary": "I - A situação em que é o Administrador da Insolvência...",
"otherFields": { "Privacidade": "1" },
"documentUrl": "https://www.dgsi.pt/jtrp.nsf/.../e386eff3a3db4ba48025890f0054a3eb?OpenDocument"
}

Notes and limits

  • DGSI returns at most 1,000 hits per query. For broader searches, split by date ranges.
  • The DGSI server rejects some queries starting with parentheses or quoted phrases; the actor reorders the query to avoid this and logs a clear message if a query is still rejected.

Source

Only official sources are used (courts, ministries or the open data published by the courts themselves). Results are returned as published by the source.

Proxy

No proxy is needed: the source is an official open service. If it starts blocking, enable proxyConfiguration (Apify RESIDENTIAL (PT) recommended, or your own proxyUrls). Requests then go through a sticky session (same IP, own cookies) with a Chrome TLS fingerprint (impit), and the IP is rotated on 403/429 or network errors.