Sign in

v1

latestOpenAPI 3.1.02026-07-241695611.0 MB
Litigation & Bankruptcy

Start Docket Adhoc Search

Starts an ad-hoc docket search using a name (and optional options).

By default, this endpoint executes synchronously and returns the completed result. Send Prefer: respond-async to opt into asynchronous execution, which returns 202 Accepted immediately and delivers results via webhooks or polling.

post/docket_searches/adhoc

Headers

Preferstring nullable

Request execution preference (RFC 7240). Use respond-async for asynchronous execution, wait=N to specify a synchronous timeout hint in seconds, or priority=low to route the task to the low-priority queue.

Example:respond-async

Request execution preference (RFC 7240). Use respond-async for asynchronous execution, wait=N to specify a synchronous timeout hint in seconds, or priority=low to route the task to the low-priority queue.

Request body

namestring required

The name to search dockets for.

optionsDocketSearchOptions[]

Options controlling which types of docket searches to run. Defaults to both civil litigations and bankruptcy. Use ['Order.Litigations'] for civil dockets only, or ['Order.Bankruptcy'] for bankruptcy only.

Example request

{
  "options": [
    "Order.Litigations"
  ]
}

Response

Response

idstring uuid required

ID of the docket search request

namestring required

The name used for the ad-hoc docket search.

state'PENDING' | 'EXECUTING' | 'COMPLETED' | 'FAILED' | 'CANCELLED' required
errorstring nullable

Any errors that occurred during the docket search request.

last_updated_atstring date required

Date the search was last updated

Example response

{
  "dockets": [
    {
      "docket_number": "A19284",
      "court": "Supreme Court of Orange County",
      "division": "Civil Court Division",
      "judges": [
        "Honorable Paul Shaw"
      ],
      "title": "Doe v. City of New York",
      "case_type": "Civil",
      "status": "Pending",
      "parties": [
        {
          "party_type": "Complaintant",
          "counsel": [
            "Robin Keller"
          ]
        }
      ],
      "updates": [
        {
          "title": "Update 2",
          "contents": "New details about the case.",
          "date": "2024-06-01",
          "exhibits": [
            {
              "title": "Exhibit 1A"
            }
          ]
        }
      ]
    }
  ]
}