Menu
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/ThomasMoreAI/legal-skills-open --skill courtlistener-apiThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Use when retrieving arbitration institutional rules (ICC, LCIA, SCC, SIAC, HKIAC, VIAC, МКАС/МАК при ТПП України, UNCITRAL) — fetching current version, verifying redaction applicable to the date of arbitration agreement, constructing URLs for official rule texts
Use when choosing the Polish legal regime for letters, requests, applications, complaints, petitions, public-information requests, KPA filings, PPSA complaints, RODO access requests, registry extracts, court-file access, tax/ZUS/cudzoziemcy/USC procedures, or professional lawyer letters. Prevents mixing UDIP, KPA, PPSA, RODO, registry, special-procedure, and advocate/radca letter regimes.
Use when preparing applications for recognition and enforcement of foreign arbitral awards in Poland, applications for setting aside arbitral awards under KPC art. 1205–1211, or opposing such applications — mapping Article V of the 1958 New York Convention to art. 1214–1215 of the Polish KPC, identifying grounds for refusal, structuring public policy arguments
Based on SOC occupation classification
Showing SKILL.md
| name | courtlistener-api |
| title | CourtListener API Guide |
| description | Legal case law database with PACER data and judge profiles |
| author | wentorai |
| author_url | https://github.com/wentorai/research-plugins/tree/main/skills/domains/law/courtlistener-api |
| license | MIT |
| version | 0.1.0 |
| execution_mode | open |
| jurisdiction | us |
| practice | litigation |
| language | en |
CourtListener is a free legal research platform operated by Free Law Project, a non-profit organization dedicated to making legal data freely accessible. The platform hosts one of the largest open collections of U.S. case law, containing millions of court opinions, docket entries, oral arguments, and judge profiles sourced from PACER (Public Access to Court Electronic Records), state court websites, and historical digitization efforts.
The CourtListener REST API provides programmatic access to this extensive legal database, enabling searches across court opinions, dockets, judge biographical data, and court information. The API covers federal courts (Supreme Court, Circuit Courts, District Courts, Bankruptcy Courts) and many state courts, with records spanning from the founding of the republic to the present day.
Legal scholars, law students, practicing attorneys, journalists, policy researchers, and civic technologists use the CourtListener API to conduct legal research, perform empirical legal studies, build litigation analytics tools, track judicial behavior, monitor active litigation, and analyze trends in case law. It serves as a critical resource for computational legal studies and access-to-justice initiatives.
No authentication is required for basic API access. The CourtListener API is publicly accessible for read operations. However, creating an account and using an API token provides higher rate limits and access to additional features. Authentication is recommended for production applications.
To obtain an API token:
Authorization header# Unauthenticated request
curl "https://www.courtlistener.com/api/rest/v4/opinions/?q=first+amendment"
# Authenticated request (higher rate limits)
curl -H "Authorization: Token YOUR_TOKEN" \
"https://www.courtlistener.com/api/rest/v4/opinions/?q=first+amendment"
Search and retrieve the full text of court opinions (judicial decisions) across all indexed courts.
GET https://www.courtlistener.com/api/rest/v4/opinions/| Parameter | Type | Required | Description |
|---|
| q | string | No | Full-text search query |
| court | string | No | Court identifier (e.g., scotus, ca9) |
| date_filed_min | string | No | Minimum filing date (YYYY-MM-DD) |
| date_filed_max | string | No | Maximum filing date (YYYY-MM-DD) |
| type | string | No | Opinion type: 010combined, 020lead, etc. |
| ordering | string | No | Sort order: date_filed, -date_filed |
| page | int | No | Page number for pagination |
curl "https://www.courtlistener.com/api/rest/v4/opinions/?q=privacy+fourth+amendment&court=scotus&ordering=-date_filed"
count, next, previous, and results array. Each opinion includes id, absolute_url, cluster (case metadata), author (judge), type, date_filed, plain_text or html (opinion text), download_url, and citations.Search and retrieve docket information including case metadata, parties, attorneys, and docket entries from PACER and other sources.
GET https://www.courtlistener.com/api/rest/v4/dockets/| Parameter | Type | Required | Description |
|---|---|---|---|
| q | string | No | Full-text search query |
| court | string | No | Court identifier |
| date_filed_min | string | No | Minimum filing date |
| date_filed_max | string | No | Maximum filing date |
| case_name | string | No | Filter by case name |
| docket_number | string | No | Filter by docket number |
| ordering | string | No | Sort order field |
curl "https://www.courtlistener.com/api/rest/v4/dockets/?q=antitrust&court=scotus&ordering=-date_filed"
count, results array with id, case_name, docket_number, court, date_filed, date_terminated, nature_of_suit, assigned_to (judge), referred_to, and docket_entries.Retrieve information about courts in the CourtListener database, including jurisdiction, location, and identifiers.
GET https://www.courtlistener.com/api/rest/v4/courts/| Parameter | Type | Required | Description |
|---|---|---|---|
| jurisdiction | string | No | Filter by jurisdiction type: F (federal), S (state) |
curl "https://www.courtlistener.com/api/rest/v4/courts/?jurisdiction=F"
id, full_name, short_name, jurisdiction, position, start_date, end_date, and url.Access biographical and professional information about judges, including their appointment history, education, and political affiliations.
GET https://www.courtlistener.com/api/rest/v4/people/| Parameter | Type | Required | Description |
|---|---|---|---|
| q | string | No | Name search query |
| court | string | No | Filter by court served |
| appointer | int | No | Filter by appointing authority |
curl "https://www.courtlistener.com/api/rest/v4/people/?q=ginsburg"
id, name_first, name_last, date_of_birth, gender, positions (court appointments with dates), education, political_affiliations, and aba_ratings.Perform a unified full-text search across all CourtListener content types.
GET https://www.courtlistener.com/api/rest/v4/search/| Parameter | Type | Required | Description |
|---|---|---|---|
| q | string | Yes | Search query |
| type | string | No | Content type: o (opinions), r (RECAP), oa (oral arguments) |
curl "https://www.courtlistener.com/api/rest/v4/search/?q=net+neutrality&type=o"
The CourtListener API allows up to 5,000 requests per hour for unauthenticated users. Authenticated users with API tokens receive higher limits. The API returns standard HTTP 429 responses when limits are exceeded. For bulk data access, CourtListener provides downloadable bulk data files at https://www.courtlistener.com/api/bulk-info/ which are more appropriate for large-scale research projects. The bulk data includes complete opinion texts, docket metadata, and judge biographical data.
Monitor new opinions from the Supreme Court of the United States:
import requests
params = {
"court": "scotus",
"ordering": "-date_filed",
"page_size": 10
}
resp = requests.get("https://www.courtlistener.com/api/rest/v4/opinions/", params=params)
data = resp.json()
for opinion in data["results"]:
cluster = opinion.get("cluster", {})
print(f"{opinion['date_filed']}: {cluster.get('case_name', 'Unknown')}")
Study citation patterns across courts and time periods:
import requests
params = {
"q": "stare decisis",
"court": "scotus",
"date_filed_min": "2020-01-01",
"ordering": "-date_filed"
}
resp = requests.get("https://www.courtlistener.com/api/rest/v4/search/", params={**params, "type": "o"})
results = resp.json()
print(f"Found {results['count']} opinions mentioning 'stare decisis' since 2020")
Research judicial appointments and their characteristics:
curl "https://www.courtlistener.com/api/rest/v4/people/?court=scotus&ordering=-date_nominated"