Skip to main content

Developers

The BenchPath API

The same verified corpus that powers this site — judge directory, procedural requirements, checklist packets, case-law search — over plain JSON.

Open & read-only

Every v1 endpoint is a GET. No API key required, no signup, CORS-enabled for browser use.

Same data as the site

These routes are the ones BenchPath itself calls. Nothing is a partner-only tier.

Fail closed

An unrecognized filter returns 404 — never a silently unscoped statewide dump.

Not legal advice

Every response carries the same verification disclaimer as the site. Verify before reliance.

Fair use: cached endpoints revalidate every 5 minutes; uncached endpoints (checklist generation, case-law search) are for interactive lookups, not bulk harvest. If you need bulk data or webhooks for change events, talk to us — usage dashboards and change-event webhooks remain on the public roadmap.

API keys

Keys are optional — every endpoint above works without one. Present a key and your traffic is attributed to your account: the response carries an x-benchpath-api-key echo header, and per-route usage is recorded against the key. A presented key that is invalid or revoked is rejected with a 401 so a dead integration fails loudly instead of silently.

curl -H "Authorization: Bearer bp_live_…" \
  https://benchpath.ai/api/v1/judges?q=miller

Key-based rate tiers and usage dashboards land after the beta. We store only a sha256 hash; the full key is shown once at creation. Key creation is not activated on this deployment yet — it opens the moment the deployment's key-derivation secret is configured, and the keys page says so. Check activation status →

Connector and plain-text records

Model Context Protocol. An assistant that speaks MCP can connect to https://benchpath.ai/api/mcp (Streamable HTTP, POST). It is read-only, needs no key and keeps no session. Its tools find judges, search rules and return a judge's or a rule's public record; each reads an address documented on this page, so a result carries the same source, confidence and verification date.

Records as Markdown. A judge's public record is at /judges/<slug>/text and a rule's at /rules/<slug>/text. Each is the same public facts as its page and names the page as its canonical address. A judge's own requirement is given by its title and summary; its verbatim text is not in the Markdown.

Response envelope

{
  "data": …,                // the payload documented below
  "meta": {
    "api": "BenchPath API v1 (beta)",
    "generated_at": "2026-07-31T…",
    "disclaimer": "Procedural information from official public sources; not legal advice and not a substitute for the advice of an attorney. …"
  }
}

Errors return { "error": "…" } with a 4xx status and a message that tells you exactly which filter failed.