[preview] Get a docket
Preview. Access is available upon request: contact support@midpage.ai. Requires an organization API key with Full access.
Retrieve a federal or state docket: case details, parties and entries. Copies served from storage are free. For a federal docket we don't have, or a copy older than max_age_hours, we fetch it from PACER and charge your PACER balance; that needs PACER fetches turned on. See Dockets and filings.
Body·
Send exactly one of case_id or docket.
Send exactly one of
case_idordocket.Send exactly one of
case_idordocket.- Type: stringcase
_id requiredA docket's
case_idfrom an earlier answer. Case-insensitive. - Type: string | nullcursor
next_cursorfrom the previous page. Repeat the originalcase_idordocketlookup. Pages are free and do not refresh the docket. - docket
- Type: integerlimitmin:1max:1000
Entries per page
- Type: integermax
_age _hours min:0At courts PACER serves, fetch again if our copy is older than this many hours.
0always fetches on the first page; retries can incur another charge. Omit to accept any held copy. Ignored on cursor pages and at other courts.
Responses
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
curl https://app.midpage.ai/api/v1/dockets/get \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"docket": {
"docket_number": "1:24-cv-00533",
"court_id": "nysd"
},
"max_age_hours": 24
}'
{
"docket": {
"case_id": "5c1f9e2a-7d43-4b8e-9a61-2f0c8d3e4b17",
"case_name": "Doe v. Acme Corp.",
"court_id": "nysd",
"court_name": "District Court, S.D. New York",
"court_abbreviation": "S.D.N.Y.",
"docket_number": "1:24-cv-00533",
"date_filed": "2024-01-24",
"date_terminated": null,
"case_status": "open",
"nature_of_suit": "190 Contract: Other",
"cause": "28:1332 Diversity-Breach of Contract",
"jurisdiction_type": "Diversity",
"jury_demand": "Plaintiff",
"demand": null,
"judges": [
{
"name": "Jane Roe",
"role": "Assigned to"
}
],
"parties": [
{
"name": "Acme Corp.",
"role": "Defendant",
"attorneys": [
{
"name": "John Smith",
"firm": "Smith LLP",
"roles": [
"LEAD ATTORNEY"
]
}
]
}
],
"related_cases": [
"1:24-cv-00612"
],
"fetched_at": "2026-10-14T13:02:11.000Z",
"entry_count": 2,
"midpage_url": "https://app.midpage.ai/case/5c1f9e2a-7d43-4b8e-9a61-2f0c8d3e4b17/docket"
},
"entries": [
{
"filing_id": "a3d0c6e1-2b5f-4f7a-8c9d-1e2f3a4b5c6d",
"entry_number": "1",
"date_filed": "2024-01-24",
"description": "COMPLAINT against Acme Corp.",
"document": "stored",
"attachments": [
{
"filing_id": "b7e2f4a9-6c1d-4e3b-9f8a-0d1c2b3a4e5f",
"attachment_number": "1",
"description": "Exhibit A",
"document": "purchasable"
}
]
},
{
"filing_id": "c9f1a2b3-4d5e-4f60-8a7b-9c0d1e2f3a4b",
"entry_number": "42",
"date_filed": "2026-09-30",
"description": "MOTION to Dismiss for Lack of Jurisdiction",
"document": "purchasable",
"attachments": []
}
],
"next_cursor": null,
"cost": {
"pacer_cents": 300,
"pacer_pages": 30,
"balance_cents": 46700
}
}