# CourtListener US Courts Directory

> CourtListener US Courts Directory is a paid API for AI agents from proxy.suverse.io, paid per call via x402, $0.06/call, status unknown (last checked 2026-09-14).

Lists US courts by jurisdiction (federal or state) from CourtListener, returning court IDs, names, citation strings, and in-use status.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/suverse-legal-courtlistener-courts
- Price: $0.06/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/courtlistener-us-courts-directory-0fc29c55
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sCCWUCvSWSsLN2wJCjZeg

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability courtlistener-us-courts-directory-0fc29c55 -d '<json body>'
```

Example prompt: Can you pull up the full list of US federal courts from CourtListener, including their court IDs, short names, and citation strings?

## When to prefer this

Use this endpoint when you need a structured, up-to-date directory of US courts (federal or state) with official CourtListener identifiers and citation strings for legal data integrations, reference lookups, or validation workflows. Prefer this over manual lookups or scraped data when you need reliable court IDs and citation strings compatible with the CourtListener ecosystem.

## Known failure modes

- CourtListener upstream API unavailable — proxy returns error or degraded response
- Invalid or missing request body structure — returns 400-level error
- Payment not processed — x402 payment required before data is returned
- Empty result set if jurisdiction filter yields no matching courts

## How this service works

List US courts by jurisdiction (F=federal, S=state) from CourtListener. Returns court id, full name, short name, citation string and in-use status. Official CourtListener REST API, keyless read access. Useful for legal-data integrations and court reference lookups.

## Output

Returns a list of US court objects from CourtListener, each containing: court ID, full court name, short name, citation string, jurisdiction type (federal or state), and whether the court is currently in use.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/courtlistener-us-courts-directory-0fc29c55/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from proxy.suverse.io](https://www.zero.xyz/host/proxy.suverse.io/llms.txt)