---
title: "List federal and state courts"
method: POST
path: "/legal/v1/courts"
tags: ["Legal"]
---

# List federal and state courts

`POST /legal/v1/courts`

Returns court IDs (slugs) and names for use with the docket search endpoint. Use the returned court ID as the `court` parameter in legal.docket().

## Request body

- object
  - `query` string — Search by court name or slug (e.g. "Northern District", "nysd", "ca9")
  - `jurisdiction` string — Optional jurisdiction code filter (e.g. FD for Federal District, F for all Federal, S for State)
  - `inUseOnly` boolean — Only return courts with available docket data
  - `limit` integer — Maximum number of courts to return
  - `offset` integer — Number of courts to skip before returning results

## Response `200`

Court list retrieved successfully

- object
  - `query` string, nullable
  - `jurisdiction` string, nullable
  - `inUseOnly` boolean — Whether results are filtered to in-use courts only
  - `found` integer
  - `courts` object[]
    - `id` string — Court slug (use as the court parameter in legal.docket())
    - `shortName` string, nullable
    - `fullName` string, nullable
    - `jurisdiction` string, nullable
    - `pacerCourtId` integer, nullable

## Other responses

- `400` — Bad request - invalid parameters
- `401` — Unauthorized - invalid API key
- `403` — Forbidden - insufficient permissions
- `502` — Bad gateway - upstream provider error
- `503` — Service unavailable - courts data source not configured

---

[API](https://skmtc.net/casemark/apis/case-dev-api.md) · [All operations](https://skmtc.net/casemark/apis/case-dev-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/casemark/case-dev-api/revisions/5b7e64e6d6f9/schema)