Get Court

GET

api

courts

{district_id}

curl 'https://api.courtrules.app/api/v1/courts/edny' \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

resp = requests.get(
    "https://api.courtrules.app/api/v1/courts/edny",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
court = resp.json()

const resp = await fetch("https://api.courtrules.app/api/v1/courts/edny", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});
const court = await resp.json();

{
  "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.

string

required

District identifier (e.g. edny)

curl 'https://api.courtrules.app/api/v1/courts/edny' \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

resp = requests.get(
    "https://api.courtrules.app/api/v1/courts/edny",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
court = resp.json()

const resp = await fetch("https://api.courtrules.app/api/v1/courts/edny", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});
const court = await resp.json();

{
  "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

string

Unique identifier (e.g. edny)

string

Full court name

string

Federal circuit (e.g. “2nd Circuit”)

string

State name

string

Coverage status: live, preview, or coming_soon

integer

Number of judges with data (only present when data exists)

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

curl 'https://api.courtrules.app/api/v1/courts/edny' \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

resp = requests.get(
    "https://api.courtrules.app/api/v1/courts/edny",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
court = resp.json()

const resp = await fetch("https://api.courtrules.app/api/v1/courts/edny", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});
const court = await resp.json();

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

Overview

Endpoints

Policies

Response fields

Error responses

403: District not accessible

404: District not found

​Response fields

​Error responses

​403: District not accessible

​404: District not found

Response fields

Error responses

403: District not accessible

404: District not found