DGSI - Portuguese Case Law Search
Pricing
from $1.00 / 1,000 results
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
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
14 days ago
Last modified
Categories
Features
Share
DGSI - Portuguese Case Law Search
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. UseANDbetween 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
documentUrlvalues indocumentUrlswithincludeFullText: true. - Every result includes
searchTermandrank;passagesholds the paragraphs where the search terms appear, ready for LLM analysis.
Coverage
| Code | Court |
|---|---|
jstj | Supremo Tribunal de Justiça |
jsta | Supremo Tribunal Administrativo |
jcon | Tribunal dos Conflitos |
jtrp / jtrl / jtrc / jtrg / jtre | Courts of Appeal (Porto, Lisboa, Coimbra, Guimarães, Évora) |
jtca / jtcn | Central Administrative Courts (South / North) |
atco1 | Constitutional 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.