CAcasemark
Legal

Search federal dockets and filings

Changed on

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

  • Base URL
    https://api.case.dev
  • URL
    https://api.case.dev/legal/v1/docket
  • Auth
    HTTP bearer

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 (maximum 200 when including lookup entries)

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)

Changes