Skip to main content
POST
/
legal
/
v1
/
docket
Search federal dockets and filings
curl --request POST \
  --url https://api.case.dev/legal/v1/docket \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "search",
  "query": "<string>",
  "court": "<string>",
  "dateFiledAfter": "2023-12-25",
  "dateFiledBefore": "2023-12-25",
  "docketId": "<string>",
  "includeEntries": false,
  "live": false,
  "limit": 25,
  "offset": 0
}
'
{
  "type": "search",
  "query": "<string>",
  "court": "<string>",
  "dateFiledAfter": "2023-12-25",
  "dateFiledBefore": "2023-12-25",
  "found": 123,
  "dockets": [
    {
      "id": "<string>",
      "caseName": "<string>",
      "docketNumber": "<string>",
      "court": "<string>",
      "courtId": "<string>",
      "dateFiled": "2023-12-25",
      "dateTerminated": "2023-12-25",
      "cause": "<string>",
      "natureOfSuit": "<string>",
      "parties": [
        "<string>"
      ],
      "assignedTo": "<string>",
      "url": "<string>",
      "pacerCaseId": "<string>"
    }
  ],
  "includeEntries": true,
  "docket": {
    "id": "<string>",
    "caseName": "<string>",
    "docketNumber": "<string>",
    "court": "<string>",
    "courtId": "<string>",
    "dateFiled": "2023-12-25",
    "dateTerminated": "2023-12-25",
    "cause": "<string>",
    "natureOfSuit": "<string>",
    "parties": [
      "<string>"
    ],
    "assignedTo": "<string>",
    "url": "<string>",
    "pacerCaseId": "<string>"
  },
  "entries": [
    {
      "entryNumber": 123,
      "date": "2023-12-25",
      "description": "<string>",
      "documents": [
        {
          "id": "<string>",
          "documentNumber": "<string>",
          "attachmentNumber": 123,
          "description": "<string>",
          "pdfUrl": "<string>",
          "pageCount": 123,
          "isAvailable": true
        }
      ]
    }
  ],
  "pagination": {
    "limit": 123,
    "offset": 123,
    "returned": 123
  }
}

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 CourtListener court slug (e.g. "nysd", "ca9", "cafc")

​
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

CourtListener docket ID (required for lookup)

​
includeEntries
boolean
default:false

Include docket entries/filings in lookup responses

​
live
boolean
default:false

Reserved for future PACER live fetch support. Setting true currently returns 400.

​
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

Required range: x >= 0

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
DocketSearchResults · object[]

Search results (search mode)

​
includeEntries
boolean

Whether entries were requested (lookup mode only)

​
docket
DocketDetail · object

Full docket record (lookup mode)

​
entries
object[] | null

Docket entries/filings (lookup mode with includeEntries)

​
pagination
object

Pagination info for entry list (lookup mode with includeEntries)