v44

latestOpenAPI 3.1.0Proprietaryraw.githubusercontent.com2026-05-192301780.0 KB

Legal

Search federal dockets and filings

Search federal court dockets or retrieve a specific docket with optional filing entries. Use legal.listCourts() to resolve court slugs for filtering.

post/legal/v1/docket

Request body

type'search' | 'lookup' required

Search dockets or look up a docket by ID

querystring

Case name or party name search query (required for search)

courtstring

Optional court slug for filtering (e.g. "nysd", "ca9", "cafc"). Use legal.listCourts() to find slugs.

dateFiledAfterstring date

Optional lower bound for filing date (YYYY-MM-DD)

dateFiledBeforestring date

Optional upper bound for filing date (YYYY-MM-DD)

docketIdstring

Docket ID (required for lookup)

includeEntriesboolean

Include docket entries/filings in lookup responses.

liveboolean

Trigger a live PACER fetch for dockets not yet in the RECAP archive. Requires acknowledgePacerFees: true. PACER charges up to $3.00 per docket sheet plus a $0.05 service fee. Only valid with type: "lookup".

acknowledgePacerFeesboolean

Required when live: true. Acknowledges that PACER fees (up to $3.00 per docket) plus a $0.05 service fee will be charged to your account.

limitinteger

Page size for search results or entry list (default 25 for search, 50 for lookup)

offsetinteger

Offset for search results or entry list

Response

Docket query completed successfully

type'search' | 'lookup'

querystring nullable

Echo of search query (search mode only)

courtstring nullable

Echo of court filter (search mode only)

dateFiledAfterstring date nullable

Echo of date filter

dateFiledBeforestring date nullable

Echo of date filter

foundinteger

includeEntriesboolean

Whether entries were requested (lookup mode only)

liveboolean

Whether this was a live PACER fetch (lookup mode only)