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

> Returns the current judges for a court, with name, type, bio, chambers address, and whether we hold their own rules

Returns the judges on a court's current roster. Use a judge's `slug` with [`/rules`](/api-reference/rules) or [`/extracted-rules`](/api-reference/extracted-rules). Works for every court in [`/courts`](/api-reference/courts), federal or state.

In some state courts the roster lists departments or courtrooms rather than individual judges. Their slugs work the same way.

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

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

<ResponseExample>
  ```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
  {
    "district_id": "ca-los-angeles-superior",
    "judges": [
      {
        "slug": "judge-teresa-a-beaudet",
        "name": "Judge Teresa A. Beaudet",
        "has_profile": false,
        "has_rules": true,
        "status": "active",
        "judge_type": "district",
        "bio": null,
        "chambers": null,
        "profile_url": null
      }
    ],
    "meta": {
      "total": 116,
      "profiled": 0,
      "with_rules": 113,
      "court_level_rules": true
    }
  }
  ```
</ResponseExample>

## Response fields

<ResponseField name="district_id" type="string">
  The court ID from the request
</ResponseField>

<ResponseField name="judges" type="array">
  Array of judge objects

  <Expandable title="Judge object">
    <ResponseField name="slug" type="string">
      URL-safe identifier used in [`/rules`](/api-reference/rules), [`/extracted-rules`](/api-reference/extracted-rules), and [`/check`](/api-reference/check) calls
    </ResponseField>

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

    <ResponseField name="has_profile" type="boolean">
      Whether the judge has a compliance profile used by [`/check`](/api-reference/check). Only `edny` judges have one today.
    </ResponseField>

    <ResponseField name="has_rules" type="boolean">
      Whether we hold the judge's own rules (standing orders, individual practices, courtroom rules). A judge without their own rules still has the court-wide rules; see `meta.court_level_rules`.
    </ResponseField>

    <ResponseField name="status" type="string | null">
      `active` for a judge on the current roster, `coming_soon` for a judge on the roster whose own documents are not processed yet. `null` when the roster has no record for the judge.
    </ResponseField>

    <ResponseField name="judge_type" type="string | null">
      Judge type (e.g. `"district"`, `"magistrate"`, `"senior"`), or `null`
    </ResponseField>

    <ResponseField name="bio" type="string | null">
      Short biography excerpt, if available
    </ResponseField>

    <ResponseField name="chambers" type="string | null">
      Chambers address, if available
    </ResponseField>

    <ResponseField name="profile_url" type="string | null">
      Link to the judge's official court profile, if available
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="meta" type="object">
  <Expandable title="Meta object">
    <ResponseField name="total" type="integer">
      Number of judges returned
    </ResponseField>

    <ResponseField name="profiled" type="integer">
      Number of judges with compliance profiles
    </ResponseField>

    <ResponseField name="with_rules" type="integer">
      Number of judges whose own rules we hold
    </ResponseField>

    <ResponseField name="court_level_rules" type="boolean">
      Whether the court has court-wide rules. They are served with `judge_slug=court` and included
      in every judge's [`/rules`](/api-reference/rules) response.
    </ResponseField>
  </Expandable>
</ResponseField>

## Errors

| Status | Meaning |
| - | - |
| `404` | The court ID is not known. |


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