Skip to main content
POST

Authorizations

Authorization
string
header
required

API key starting with sk_case_

Body

application/json

Docket query parameters

type
enum<string>
required

Search dockets or look up a docket by ID

Available options:
search,
lookup
query
string

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

Required string length: 2 - 500
court
string

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

dateFiledAfter
string<date>

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

dateFiledBefore
string<date>

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

docketId
string

Docket ID (required for lookup)

includeEntries
boolean
default:false

Include docket entries/filings in lookup responses.

live
boolean
default:false

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".

acknowledgePacerFees
boolean
default:false

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.

limit
integer
default:25

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

Required range: 1 <= x <= 100
offset
integer
default:0

Offset for search results or entry list (maximum 200 when including lookup entries)

Required range: 0 <= x <= 200

Response

Docket query completed successfully

type
enum<string>
Available options:
search,
lookup
query
string | null

Echo of search query (search mode only)

court
string | null

Echo of court filter (search mode only)

dateFiledAfter
string<date> | null

Echo of date filter

dateFiledBefore
string<date> | null

Echo of date filter

found
integer
dockets
DocketSearchResult · object[]

Search results (search mode)

includeEntries
boolean

Whether entries were requested (lookup mode only)

docket
DocketDetail · object | null

Full docket record (lookup mode)

entries
object[] | null

Docket entries/filings (lookup mode with includeEntries)

pagination
object | null

Pagination info for entry list (lookup mode with includeEntries)

live
boolean

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

pacerFees
object | null

PACER fee information (present when live: true)