> ## 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.

# List Courts

> Returns all courts with coverage status

Returns all courts with their coverage status, circuit, state, and judge counts.

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

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

<ResponseExample>
  ```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
  {
    "courts": [
      {
        "district_id": "edny",
        "name": "Eastern District of New York",
        "circuit": "2nd Circuit",
        "state": "New York",
        "status": "live",
        "judges_mapped": 47,
        "judges_profiled": 47
      },
      {
        "district_id": "sdny",
        "name": "Southern District of New York",
        "circuit": "2nd Circuit",
        "state": "New York",
        "status": "preview",
        "judges_mapped": 45
      },
      {
        "district_id": "ct",
        "name": "District of Connecticut",
        "circuit": "2nd Circuit",
        "state": "Connecticut",
        "status": "coming_soon"
      }
    ],
    "meta": {
      "total_districts": 94,
      "districts_with_data": 20,
      "accessible_districts": ["edny"],
      "total_judges_mapped": 850
    }
  }
  ```
</ResponseExample>

## Response fields

<ResponseField name="courts" type="array">
  Array of court objects

  <Expandable title="Court object">
    <ResponseField name="district_id" type="string">
      Unique identifier (e.g. `edny`, `sdny`, `cdca`)
    </ResponseField>

    <ResponseField name="name" type="string">
      Full court name (e.g. "Eastern District of New York")
    </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` (see below)
    </ResponseField>

    <ResponseField name="judges_mapped" type="integer">
      Number of judges with data. Only present when the court has judge data.
    </ResponseField>

    <ResponseField name="judges_profiled" type="integer">
      Number of judges with standing order profiles. Only present for `live` districts.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="meta" type="object">
  <Expandable title="Meta">
    <ResponseField name="total_districts" type="integer">
      Total number of courts
    </ResponseField>

    <ResponseField name="districts_with_data" type="integer">
      Districts that have at least one judge mapped
    </ResponseField>

    <ResponseField name="accessible_districts" type="array">
      District IDs currently accessible via the API
    </ResponseField>

    <ResponseField name="total_judges_mapped" type="integer">
      Total judges across all districts with data
    </ResponseField>
  </Expandable>
</ResponseField>

## Status field

| Status        | Meaning                                                           |
| ------------- | ----------------------------------------------------------------- |
| `live`        | Full API access. All endpoints work for this district.            |
| `preview`     | Judge data exists but the district is not yet accessible via API. |
| `coming_soon` | District is mapped but no data yet.                               |