Skip to main content
GET
/
api
/
v1
/
courts
/
{district_id}
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,
  "judges_profiled": 47
}
Returns detailed information for a single court, including coverage status and judge counts.
​
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,
  "judges_profiled": 47
}

​
Response fields

​
district_id
string
Unique identifier (e.g. edny)
​
name
string
Full court name
​
circuit
string
Federal circuit (e.g. “2nd Circuit”)
​
state
string
State name
​
status
string
Coverage status: live, preview, or coming_soon
​
judges_mapped
integer
Number of judges with data (only present when data exists)
​
judges_profiled
integer
Number of judges with standing order profiles (only present for live districts)

​
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.
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."
}