# CourtListener · Search dockets

Search public records with CourtListener · Search dockets from Alexandria through one Spiral API key. Search federal PACER dockets (RECAP archive) on CourtListener by party name, attorney, case name, docket number, judge, nature of suit, cause, court and filing dates, or look one docket up by docket_id. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

- Provider: Alexandria
- Category: Public Records
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `courtlistener-com/dockets/search_dockets`
- Page: https://spiral.ai/tools/alexandria/courtlistener-com/dockets/search_dockets

## Pricing

$0.00873 per call.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 5 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `cause` | text |  | — | cause |
| `court` | list |  | — | CourtListener court ids (not jurisdiction or state names) to restrict the search to, e.g. scotus, ca9, nysd, cal, calctapp, ny, nyappdiv, tex, texapp, fla. An unknown id such as texas, tx or ca matches nothing and returns zero results. List every court you need: ny does not include nyappdiv. Use the courts function to find ids (jurisdiction S / SA are state supreme and appellate courts). |
| `judge` | text |  | — | Assigned judge name. |
| `query` | text |  | — | Full-text query over docket metadata; supports fielded clauses such as party:(Google) or docketNumber:"1:20-cv-03010". |
| `cursor` | text |  | — | Not served keyless: the feeds have no further pages, so any cursor fails with a non-retryable upstream_blocked error. |
| `order_by` | one of | score desc, dateFiled desc, dateFiled asc | score desc | Keyless feeds always return the newest matches first. score desc (default) and dateFiled desc are accepted; other orders need a CourtListener API token and fail with a non-retryable upstream_blocked error. |
| `case_name` | text |  | — | case_name |
| `docket_id` | number | 1 to … | — | CourtListener docket id for a single-docket lookup. |
| `party_name` | text |  | — | Party name. CourtListener stems and tokenizes it, so Bakers also matches Baker; set party_name_exact for an exact phrase. |
| `filed_after` | text |  | — | Earliest filing date, inclusive (YYYY-MM-DD). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. |
| `filed_before` | text |  | — | Latest filing date, inclusive (YYYY-MM-DD). Use the same date as filed_after for a single day. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. |
| `attorney_name` | text |  | — | attorney_name |
| `docket_number` | text |  | — | PACER docket number, e.g. 1:20-cv-03010. Combine with court for an exact match. |
| `nature_of_suit` | text |  | — | nature_of_suit |
| `party_name_exact` | true or false |  | — | Match party_name as an exact quoted phrase without stemming, so Bakers no longer matches Baker or Bake. Requires party_name. |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "courtlistener-com/dockets/search_dockets",
    "input": {
      "query": "<query>"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=courtlistener-com%2Fdockets%2Fsearch_dockets

## Common questions

### CourtListener · Search dockets

**How much does CourtListener · Search dockets cost?**

$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use CourtListener · Search dockets through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "courtlistener-com/dockets/search_dockets"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with Alexandria to use CourtListener · Search dockets?**

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

**Can my AI agent use CourtListener · Search dockets?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

