> ## 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 all judges for a court, including name, type, bio, chambers address, and standing order availability

<ParamField query="district_id" type="string" required>
  District identifier (e.g. `edny`). Use [`GET /api/v1/courts`](/api-reference/courts) to see which
  districts are accessible in your plan.
</ParamField>

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

<ResponseExample>
  ```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
  {
    "district_id": "edny",
    "judges": [
      {
        "slug": "nicholas-g-garaufis",
        "name": "Nicholas G. Garaufis",
        "has_profile": true,
        "judge_type": "district",
        "bio": "Senior United States District Judge for the Eastern District of New York...",
        "chambers": "225 Cadman Plaza East, Brooklyn, NY 11201",
        "profile_url": "https://www.nyed.uscourts.gov/judges/nicholas-g-garaufis"
      },
      {
        "slug": "carol-bagley-amon",
        "name": "Carol Bagley Amon",
        "has_profile": true,
        "judge_type": "senior",
        "bio": null,
        "chambers": null,
        "profile_url": null
      }
    ],
    "meta": {
      "total": 47,
      "profiled": 47
    }
  }
  ```
</ResponseExample>

## Response fields

<ResponseField name="district_id" type="string">
  The district 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) and [`/check`](/api-reference/check) calls (e.g. `nicholas-g-garaufis`)
    </ResponseField>

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

    <ResponseField name="has_profile" type="boolean">
      Whether this judge has a standing order profile with judge-specific rules
    </ResponseField>

    <ResponseField name="judge_type" type="string | null">
      `"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">
      Total number of judges in the district
    </ResponseField>

    <ResponseField name="profiled" type="integer">
      Number of judges with standing order profiles
    </ResponseField>
  </Expandable>
</ResponseField>
