Errors

{
  "meta": {
    "request_id": "req_01jt7y4kx0",
    "queried_at": "2026-04-29T12:00:00Z"
  },
  "error": {
    "code": "court_not_covered",
    "message": "Court code 'xyz' is not recognized.",
    "documentation_url": "https://docketlayer.ai/reference/errors#court_not_covered"
  }
}

response = client.get("https://api.docketlayer.ai/v2/case", params={...})

if response.status_code == 200:
    data = response.json()
    # Process docket data

elif response.status_code == 402:
    # Payment failed
    # Check: wallet balance, x402 configuration, Solana network status

elif response.status_code == 404:
    err = response.json()["error"]
    if err["code"] == "case_not_found":
        # The case was not found — DocketLayer has enqueued it for scraping
        # Retry in a few minutes
        pass

elif response.status_code == 422:
    # Court not covered
    # Check /v2/status for current coverage list

elif response.status_code == 429:
    # Rate limited — 60 req/min, 10,000 req/day per wallet
    retry_after = response.json()["error"].get("details", {}).get("retry_after")
    time.sleep(retry_after or 60)

elif response.status_code == 503:
    # Upstream court system temporarily unavailable
    # Retry with exponential backoff — check /v2/status for current system state

curl https://api.docketlayer.ai/v2/status