Endpoints
List Courts
Returns all courts with coverage status
GET
/
api
/
v1
/
courts
curl 'https://api.courtrules.app/api/v1/courts' \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
resp = requests.get(
"https://api.courtrules.app/api/v1/courts",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
courts = resp.json()
const resp = await fetch("https://api.courtrules.app/api/v1/courts", {
headers: { Authorization: "Bearer YOUR_API_KEY" },
});
const courts = await resp.json();
{
"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
}
}
Returns all courts with their coverage status, circuit, state, and judge counts.
curl 'https://api.courtrules.app/api/v1/courts' \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
resp = requests.get(
"https://api.courtrules.app/api/v1/courts",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
courts = resp.json()
const resp = await fetch("https://api.courtrules.app/api/v1/courts", {
headers: { Authorization: "Bearer YOUR_API_KEY" },
});
const courts = await resp.json();
{
"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
}
}
Response fields
array
Array of court objects
Show Court object
Show Court object
string
Unique identifier (e.g.
edny, sdny, cdca)string
Full court name (e.g. “Eastern District of New York”)
string
Federal circuit (e.g. “2nd Circuit”)
string
State name
string
Coverage status:
live, preview, or coming_soon (see below)integer
Number of judges with data. Only present when the court has judge data.
integer
Number of judges with standing order profiles. Only present for
live districts.object
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. |
⌘I
curl 'https://api.courtrules.app/api/v1/courts' \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
resp = requests.get(
"https://api.courtrules.app/api/v1/courts",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
courts = resp.json()
const resp = await fetch("https://api.courtrules.app/api/v1/courts", {
headers: { Authorization: "Bearer YOUR_API_KEY" },
});
const courts = await resp.json();
{
"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
}
}