> ## 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 detailed information for a single court, including coverage status and judge counts.

<ParamField path="district_id" type="string" required>
  District identifier (e.g. `edny`)
</ParamField>

<RequestExample>
  ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
  curl 'https://api.courtrules.app/api/v1/courts/edny' \
    -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/edny",
      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/edny", {
    headers: { Authorization: "Bearer YOUR_API_KEY" },
  });
  const court = await resp.json();
  ```
</RequestExample>

<ResponseExample>
  ```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
  {
    "district_id": "edny",
    "name": "Eastern District of New York",
    "circuit": "2nd Circuit",
    "state": "New York",
    "status": "live",
    "judges_mapped": 47,
    "judges_profiled": 47
  }
  ```
</ResponseExample>

## Response fields

<ResponseField name="district_id" type="string">
  Unique identifier (e.g. `edny`)
</ResponseField>

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

<ResponseField name="circuit" type="string">
  Federal circuit (e.g. "2nd Circuit")
</ResponseField>

<ResponseField name="state" type="string">
  State name
</ResponseField>

<ResponseField name="status" type="string">
  Coverage status: `live`, `preview`, or `coming_soon`
</ResponseField>

<ResponseField name="judges_mapped" type="integer">
  Number of judges with data (only present when data exists)
</ResponseField>

<ResponseField name="judges_profiled" type="integer">
  Number of judges with standing order profiles (only present for `live` districts)
</ResponseField>

## Error responses

### 403: District not accessible

When a district exists but is not yet accessible, the API returns a structured 403 (not a 404). The district exists conceptually, but is not available in your plan.

```json 403 theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "error": "District 'sdny' is not yet accessible.",
  "district": {
    "district_id": "sdny",
    "name": "Southern District of New York",
    "status": "preview",
    "judges_mapped": 45
  },
  "accessible_districts": ["edny"],
  "contact": "api@courtrules.app"
}
```

### 404: District not found

Returned only when the district ID is not recognized at all.

```json 404 theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "error": "District 'xyz' not found."
}
```