> ## Documentation Index
> Fetch the complete documentation index at: https://docs.courtrules.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Court

> Returns detailed information for a single court

Returns one court's circuit, state, coverage status, and roster size. Works for every court in [`/courts`](/api-reference/courts), federal or state.

<ParamField path="district_id" type="string" required>
  Court identifier (e.g. `edny`, `ca-los-angeles-superior`)
</ParamField>

<RequestExample>
  ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
  curl 'https://api.courtrules.app/api/v1/courts/ca-los-angeles-superior' \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
  import requests

  resp = requests.get(
      "https://api.courtrules.app/api/v1/courts/ca-los-angeles-superior",
      headers={"Authorization": "Bearer YOUR_API_KEY"},
  )
  court = resp.json()
  ```

  ```typescript Node.js theme={"theme":{"light":"github-light","dark":"github-dark"}}
  const resp = await fetch("https://api.courtrules.app/api/v1/courts/ca-los-angeles-superior", {
    headers: { Authorization: "Bearer YOUR_API_KEY" },
  });
  const court = await resp.json();
  ```
</RequestExample>

<ResponseExample>
  ```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
  {
    "district_id": "ca-los-angeles-superior",
    "name": "Superior Court of California, County of Los Angeles",
    "circuit": null,
    "state": "California",
    "status": "live",
    "judges_mapped": 116
  }
  ```
</ResponseExample>

## Response fields

<ResponseField name="district_id" type="string">
  Unique court identifier
</ResponseField>

<ResponseField name="name" type="string">
  Full court name
</ResponseField>

<ResponseField name="circuit" type="string | null">
  Federal circuit (e.g. "2nd Circuit"). `null` for state courts.
</ResponseField>

<ResponseField name="state" type="string | null">
  State or territory. `null` for courts not tied to one state.
</ResponseField>

<ResponseField name="status" type="string">
  `live` when rules are available, `coming_soon` when the court is mapped but has no rules yet
</ResponseField>

<ResponseField name="judges_mapped" type="integer">
  Number of current judges on the court's roster
</ResponseField>

<ResponseField name="judges_profiled" type="integer">
  Number of judges with compliance profiles used by [`/check`](/api-reference/check). Only present
  for courts with compliance profiles (`edny` today).
</ResponseField>

## Error responses

### 404: Court not found

Returned when the court ID is not recognized.

```json 404 theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "error": "District 'xyz' not found.",
  "suggestion": "Use GET /api/v1/courts to list all valid district identifiers.",
  "docs_url": "https://docs.courtrules.app/api-reference/courts/list-courts"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.