{
  "name": "Aletheca API",
  "version": "v1",
  "documentation": "https://aletheca.com/developers",
  "description": "Freedom of Information Act requests, their dispositions, and the documents they return. Reads are open; hosted writes require a Thaumatica member session.",
  "license": "https://creativecommons.org/publicdomain/zero/1.0/",
  "resources": [
    {
      "method": "GET",
      "path": "/api/v1/requests",
      "summary": "Every filed request, filtered.",
      "auth": "none",
      "params": [
        "agency",
        "disposition",
        "tag",
        "q",
        "sort",
        "limit",
        "cursor"
      ]
    },
    {
      "method": "GET",
      "path": "/api/v1/requests/{id}",
      "summary": "One request with its cost, correspondence and documents.",
      "auth": "none",
      "params": []
    },
    {
      "method": "GET",
      "path": "/api/v1/requests/{id}/events",
      "summary": "The full public ledger for one request.",
      "auth": "none",
      "params": []
    },
    {
      "method": "GET",
      "path": "/api/v1/events",
      "summary": "The firehose — every public event, newest first.",
      "auth": "none",
      "params": [
        "since",
        "category",
        "type",
        "limit"
      ]
    },
    {
      "method": "GET",
      "path": "/api/v1/documents",
      "summary": "Released documents with pages, exemptions and OCR state.",
      "auth": "none",
      "params": [
        "q",
        "exemption",
        "agency"
      ]
    },
    {
      "method": "GET",
      "path": "/api/v1/documents/{id}/file",
      "summary": "Stream an ingested public source file, with range support.",
      "auth": "none",
      "params": []
    },
    {
      "method": "GET",
      "path": "/api/v1/agencies",
      "summary": "The register — 1,380 federal, state and international bodies with statute, deadline and intake routes. jurisdiction is federal|state|foreign; country filters the international layer by ISO code.",
      "auth": "none",
      "params": [
        "jurisdiction",
        "state",
        "country",
        "category",
        "parent",
        "q",
        "scorecards",
        "limit",
        "cursor"
      ]
    },
    {
      "method": "GET",
      "path": "/api/v1/agencies/{slug}",
      "summary": "One body: register entry, components, and a scorecard where Aletheca has filed.",
      "auth": "none",
      "params": []
    },
    {
      "method": "GET",
      "path": "/api/v1/laws",
      "summary": "All 74 statutes — 58 US public-records laws plus 16 international FOI regimes — with deadlines, appeal paths and fee-waiver standards.",
      "auth": "none",
      "params": [
        "jurisdiction",
        "q",
        "limit",
        "cursor"
      ]
    },
    {
      "method": "GET",
      "path": "/api/v1/laws/{id}",
      "summary": "One statute in full, with the bodies that answer to it.",
      "auth": "none",
      "params": []
    },
    {
      "method": "GET",
      "path": "/api/v1/coverage",
      "summary": "What Aletheca can file against, with the confidence of each layer.",
      "auth": "none",
      "params": []
    },
    {
      "method": "GET",
      "path": "/api/v1/jurisdictions",
      "summary": "Local governments — 52,105 counties, municipalities, townships and school districts, named from Census files.",
      "auth": "none",
      "params": [
        "state",
        "kind",
        "q",
        "limit",
        "cursor"
      ]
    },
    {
      "method": "GET",
      "path": "/api/v1/jurisdictions/{state}/{geoid}",
      "summary": "One local government: classification, governing statute, and the offices that hold records.",
      "auth": "none",
      "params": []
    },
    {
      "method": "GET",
      "path": "/api/v1/docket",
      "summary": "Open proposals with votes, funding and quorum.",
      "auth": "none",
      "params": [
        "status",
        "campaign",
        "sort"
      ]
    },
    {
      "method": "GET",
      "path": "/api/v1/dispositions",
      "summary": "The controlled vocabulary, with tones and clock semantics.",
      "auth": "none",
      "params": []
    },
    {
      "method": "POST",
      "path": "/api/v1/proposals",
      "summary": "Save one or more tailored proposals to the Docket.",
      "auth": "user",
      "params": []
    },
    {
      "method": "POST",
      "path": "/api/v1/requests",
      "summary": "Save one or more tailored commissions for review; no charge or dispatch occurs here.",
      "auth": "user",
      "params": []
    },
    {
      "method": "POST",
      "path": "/api/v1/requests/{id}/checkout",
      "summary": "Open Stripe Checkout for an owned, reviewed commission quote.",
      "auth": "user",
      "params": []
    },
    {
      "method": "POST",
      "path": "/api/v1/checkouts/funding",
      "summary": "Open Stripe Checkout for a proposal or campaign contribution.",
      "auth": "user",
      "params": []
    }
  ],
  "holdings": {
    "register_bodies": 1380,
    "international_bodies": 18,
    "local_governments": 52105,
    "statutes": 74,
    "counties_covered": 3224,
    "county_offices_reachable": 41912,
    "coverage_note": "https://aletheca.com/api/v1/coverage"
  },
  "webhook_events": [],
  "embed": "https://aletheca.com/embed/v1.js"
}