Skip to main content

​
Courts

Two endpoints for browsing the federal court system.

​
List all courts

GET /api/v1/courts
Returns all 94 federal district courts with their coverage status, circuit, state, and judge counts. 
curl 'https://api.courtrules.app/api/v1/courts' \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "courts": [
    {
      "district_id": "edny",
      "name": "Eastern District of New York",
      "circuit": "2nd Circuit",
      "state": "New York",
      "status": "live",
      "judges_mapped": 47,
      "full_profiles": 3
    },
    {
      "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
  }
}

​
Response fields

​
courts
array
Array of court objects
​
meta
object

​
Status field

StatusMeaning
liveFull API access. All endpoints work for this district.
previewJudge data exists but the district is not yet accessible via API.
coming_soonDistrict is mapped but no data yet.

​
Get a single court

GET /api/v1/courts/{district_id}
Returns detailed information for a single court.
​
district_id
string
required
District identifier (e.g. edny)
curl 'https://api.courtrules.app/api/v1/courts/edny' \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "district_id": "edny",
  "name": "Eastern District of New York",
  "circuit": "2nd Circuit",
  "state": "New York",
  "status": "live",
  "judges_mapped": 47,
  "full_profiles": 3
}

​
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 — you just don’t have access yet. 
curl 'https://api.courtrules.app/api/v1/courts/sdny' \
  -H "Authorization: Bearer YOUR_API_KEY"
403
{
  "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.
404
{
  "error": "District 'xyz' not found."
}