{"openapi":"3.1.0","info":{"title":"Singapore Hansard Gateway","description":"Read-only gateway to Singapore Parliamentary Reports (Hansard), served as\nplain HTML/JSON/text. Every page is server-rendered: no JavaScript, no login\nforms, no third-party resources.\n\n## How to use it\n\n1. You hold a capability token (a string like ``hg_...``). ALL content lives\n   under the prefix ``/a/{token}/`` — substitute your token verbatim.\n   Invalid or revoked tokens return HTTP 404 on every path (by design:\n   identical body, no enumeration).\n2. Start at ``GET /a/{token}/`` — it lists the endpoint families with\n   token-preserving example links.\n3. Search: ``GET /a/{token}/search?q=...`` returns a results page whose\n   links are token-preserving. Follow one to read a report.\n4. Read a report: ``GET /a/{token}/report/{report_id}`` returns the full\n   verbatim transcript with a SHA-256 integrity footer.\n5. Browse a sitting: ``GET /a/{token}/date/{yyyy-mm-dd}`` lists every\n   report for one sitting date.\n\n## Formats\n\nEvery content route (report/search/date) accepts ``?format=html`` (default),\n``json`` (structured data, best for programmatic parsing), or ``text``\n(machine-readable plain text). HTML pages contain no scripts and no external\nURLs other than the SPRS provenance link in the report footer.\n\n## Errors\n\n404 = unknown/invalid/revoked token OR unknown report id. 422 = bad\nparameters. 429 = your token's rate limit. 502/503 = the upstream parliament\nsite failed or was saturated; retry later — no content is fabricated.\n\n## Retry semantics (429 / 502 / 503)\n\nNo ``Retry-After`` header is emitted today. On 429 (your rate limit), apply\nbounded exponential backoff with jitter (start around 1-2s, double per\nattempt, cap at roughly 30s) and stop after a few attempts — do not retry in\na tight loop. On 502/503 (upstream failure or saturation), the upstream is\ntransiently down; back off the same way and retry later. 404 and 422 are\nterminal for that request — retrying the identical request will not help; fix\nthe token or the parameters first.\n\n## Public (no token)\n\n``/`` and ``/about`` (documentation), ``/health`` (liveness JSON),\n``/robots.txt``, ``/openapi.json`` (this document), ``/docs`` (interactive\nSwagger UI).","version":"0.1.0"},"paths":{"/":{"get":{"summary":"Public Home","description":"Public home: documentation with placeholder links only.","operationId":"public_home__get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/about":{"get":{"summary":"About","description":"Public about: provenance / not-affiliated statement (spec §25).","operationId":"about_about_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/health":{"get":{"summary":"Health","description":"Local health: JSON status with NO upstream call (spec §24).","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response Health Health Get"}}}}}}},"/robots.txt":{"get":{"summary":"Robots","description":"robots.txt: disallow the token-bearing prefix (addendum §13).\n\nServes the operator's override file when ``cfg.robots_path`` points at\nan existing file (27.2-REQ-05); otherwise the built-in default body.\nRetrieval policy, NOT access control (RFC 9309). Closes over ``cfg``\n(the per-app settings) so the ``app_settings`` test seam works.","operationId":"robots_robots_txt_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/a/{token}/report/{report_id}":{"get":{"summary":"Report","description":"Retrieve ONE Hansard report (a full sitting transcript segment).\n\n``report_id`` is either a spec-style id (``037_20041019_S0004_T0023``)\nor a live reportId (``bill-742``). Returns the verbatim transcript —\nspeaker by speaker — with a SHA-256 integrity footer. Use\n``format=json`` for structured data, ``text`` for plain text.","operationId":"report_a__token__report__report_id__get","parameters":[{"name":"report_id","in":"path","required":true,"schema":{"type":"string","title":"Report Id"}},{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["html","json","text"],"default":"html"},"description":"Response format: ``html`` (default), ``json`` (structured), or ``text`` (plain)."}],"responses":{"200":{"description":"One full Hansard report (verbatim transcript), in the requested format.","content":{"application/json":{"schema":{"type":"object","properties":{"report_id":{"type":"string","description":"The report id that was requested (spec-style or live reportId)."},"date":{"type":"string","format":"date","description":"Sitting date (yyyy-mm-dd)."},"title":{"type":"string"},"topic_type":{"type":["string","null"],"description":"Topic/section type or null."},"source_url":{"type":"string","description":"Official SPRS provenance URL."},"volume":{"type":["string","null"],"description":"Hansard volume or null."},"parliament_no":{"type":["string","null"],"description":"Parliament number or null."},"session_no":{"type":["string","null"],"description":"Session number or null."},"sitting_no":{"type":["string","null"],"description":"Sitting number or null."},"speeches":{"type":"array","items":{"type":"object","properties":{"sequence":{"type":"integer","description":"1-based speech order in the sitting."},"speaker_original":{"type":["string","null"],"description":"Source speaker text verbatim (legal record)."},"speaker_name":{"type":["string","null"],"description":"Normalized member name or null."},"speaker_role":{"type":["string","null"],"description":"Normalized role (e.g. 'MP', 'Minister') or null."},"paragraphs":{"type":"array","items":{"type":"string"},"description":"Verbatim transcript paragraphs, in order."}}},"description":"The verbatim transcript, speaker by speaker."},"transcript_sha256":{"type":"string","description":"SHA-256 hex digest of the normalized transcript (integrity). Canonicalization (R-3): flatten ``speeches`` in ``sequence`` order and collect every ``paragraph`` string verbatim (no speaker labels, no per-speech separator); join the paragraphs with a single line feed (\"\\n\"); UTF-8-encode; SHA-256; hex-encode lowercase. Speaker fields are NOT part of the digest. The HTML and JSON renderings of the same report expose the identical digest."},"url":{"type":"string","description":"Absolute, token-bearing URL for this report (self link)."},"links":{"type":"object","description":"Absolute, token-bearing navigation links (server-generated).","properties":{"self":{"type":"string","description":"URL of this report."},"sitting":{"type":"string","description":"URL of this sitting's table of contents (/date)."}}}}},"description":"Structured report with transcript + SHA-256 (format=json)."},"text/html":{"schema":{"type":"string"},"description":"Server-rendered report page (format=html, default)."},"text/plain":{"schema":{"type":"string"},"description":"Machine-readable plain text (format=text)."}}},"404":{"description":"Invalid/revoked token OR unknown/invalid report id — the SAME body for both (identical HTML error page, by design: no enumeration).","content":{"text/html":{"schema":{"type":"string"},"description":"HTML error page."}}},"422":{"description":"Bad parameters (query too long, date not yyyy-mm-dd, bad format, invalid report id). JSON: the error envelope ``{\"error\": {\"code\": \"invalid_parameter\", \"message\": <string>, \"retryable\": false}}``.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"}},"required":["code","message","retryable"]}},"required":["error"]},"description":"Invalid report id / format."}}},"429":{"description":"Rate limit exhausted. JSON: ``{\"error\": {\"code\": \"rate_limited\", \"message\": \"Rate limit exceeded.\", \"retryable\": true}}``. No Retry-After; apply bounded exponential backoff and retry.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"}},"required":["code","message","retryable"]}},"required":["error"]},"description":"Rate limited."}}},"502":{"description":"Upstream (SPRS) temporarily unavailable (502) or saturated (503). JSON: ``{\"error\": {\"code\": \"upstream_unavailable\", \"message\": <string>, \"retryable\": true}}``; text: a one-line message; html: the static error page. Retry with bounded exponential backoff; no content is fabricated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"}},"required":["code","message","retryable"]}},"required":["error"]},"description":"Upstream unavailable (json)."}}},"503":{"description":"Upstream (SPRS) temporarily unavailable (502) or saturated (503). JSON: ``{\"error\": {\"code\": \"upstream_unavailable\", \"message\": <string>, \"retryable\": true}}``; text: a one-line message; html: the static error page. Retry with bounded exponential backoff; no content is fabricated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"}},"required":["code","message","retryable"]}},"required":["error"]},"description":"Upstream saturated (json)."}}}}}},"/a/{token}/search":{"get":{"summary":"Search","description":"Search Hansard for ``q``; filters ``from_``/``to``/``speaker``/\n``page``/``limit``. Every result link is token-preserving.","operationId":"search_a__token__search_get","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}},{"name":"q","in":"query","required":true,"schema":{"type":"string","title":"Q"}},{"name":"from_","in":"query","required":false,"schema":{"type":"string","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":"Earliest sitting date filter (yyyy-mm-dd)."},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":"Latest sitting date filter (yyyy-mm-dd)."},{"name":"speaker","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Speaker"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["html","json","text"],"default":"html"},"description":"Response format: ``html`` (default), ``json`` (structured), or ``text`` (plain)."}],"responses":{"200":{"description":"A page of search results, in the requested format.","content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"The search phrase echoed back."},"total":{"type":"integer","description":"Total matching hits (all pages)."},"page":{"type":"integer","description":"Current page (1-based)."},"limit":{"type":"integer","description":"Hits per page."},"hits":{"type":"array","items":{"type":"object","properties":{"report_id":{"type":"string","description":"Spec-style report id, e.g. ``037_20041019_S0004_T0023``."},"link_id":{"type":"string","description":"Report identifier. To follow this hit, GET the token-preserving link ``/a/{token}/report/{link_id}`` — substitute your token for ``{token}`` and this value for ``{{link_id}}``. (The ``format=text`` rendering prints the bare ``/report/{link_id}``; the token-bearing form above is the canonical one to fetch.)"},"date":{"type":["string","null"],"format":"date","description":"Sitting date (yyyy-mm-dd) or null."},"title":{"type":"string"},"report_type":{"type":["string","null"],"description":"Section/topic type, e.g. 'Bill' or null."},"speaker":{"type":["string","null"],"description":"Primary speaker (member name) or null."},"excerpt":{"type":["string","null"],"description":"Result excerpt snippet or null."},"url":{"type":"string","description":"Absolute, token-bearing URL for this hit's full report — GET it directly to read the transcript (no need to construct the URL). Server-generated from your request token."}}}},"provider":{"type":"string","description":"Authoritative provider ('sprs')."},"rendered_total":{"type":"integer","description":"Exact number of hits the provider retrieved for this query (F-4); 'total' is an upstream estimate."}}},"description":"Structured results page (format=json)."},"text/html":{"schema":{"type":"string"},"description":"Server-rendered results page (format=html, default)."},"text/plain":{"schema":{"type":"string"},"description":"Machine-readable plain text (format=text)."}}},"404":{"description":"Invalid/revoked token OR unknown/invalid report id — the SAME body for both (identical HTML error page, by design: no enumeration).","content":{"text/html":{"schema":{"type":"string"},"description":"HTML error page."}}},"422":{"description":"Bad parameters (query too long, date not yyyy-mm-dd, bad format, invalid report id). JSON: the error envelope ``{\"error\": {\"code\": \"invalid_parameter\", \"message\": <string>, \"retryable\": false}}``.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"}},"required":["code","message","retryable"]}},"required":["error"]},"description":"Bad parameters."}}},"429":{"description":"Rate limit exhausted. JSON: ``{\"error\": {\"code\": \"rate_limited\", \"message\": \"Rate limit exceeded.\", \"retryable\": true}}``. No Retry-After; apply bounded exponential backoff and retry.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"}},"required":["code","message","retryable"]}},"required":["error"]},"description":"Rate limited."}}},"502":{"description":"Upstream (SPRS) temporarily unavailable (502) or saturated (503). JSON: ``{\"error\": {\"code\": \"upstream_unavailable\", \"message\": <string>, \"retryable\": true}}``; text: a one-line message; html: the static error page. Retry with bounded exponential backoff; no content is fabricated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"}},"required":["code","message","retryable"]}},"required":["error"]},"description":"Upstream unavailable (json)."}}},"503":{"description":"Upstream (SPRS) temporarily unavailable (502) or saturated (503). JSON: ``{\"error\": {\"code\": \"upstream_unavailable\", \"message\": <string>, \"retryable\": true}}``; text: a one-line message; html: the static error page. Retry with bounded exponential backoff; no content is fabricated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"}},"required":["code","message","retryable"]}},"required":["error"]},"description":"Upstream saturated (json)."}}}}}},"/a/{token}/date/{day}":{"get":{"summary":"Date Toc","description":"The sitting TOC (``yyyy-mm-dd``): every report for that day.","operationId":"date_toc_a__token__date__day__get","parameters":[{"name":"day","in":"path","required":true,"schema":{"type":"string","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":"The sitting date (yyyy-mm-dd)."},{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["html","json","text"],"default":"html"},"description":"Response format: ``html`` (default), ``json`` (structured), or ``text`` (plain)."}],"responses":{"200":{"description":"The table of contents for one sitting date, in the requested format.","content":{"application/json":{"schema":{"type":"object","properties":{"date":{"type":"string","format":"date","description":"The sitting date (yyyy-mm-dd), echoed back."},"hits":{"type":"array","items":{"type":"object","properties":{"report_id":{"type":"string","description":"Spec-style report id, e.g. ``037_20041019_S0004_T0023``."},"link_id":{"type":"string","description":"Report identifier. To follow this hit, GET the token-preserving link ``/a/{token}/report/{link_id}`` — substitute your token for ``{token}`` and this value for ``{{link_id}}``. (The ``format=text`` rendering prints the bare ``/report/{link_id}``; the token-bearing form above is the canonical one to fetch.)"},"date":{"type":["string","null"],"format":"date","description":"Sitting date (yyyy-mm-dd) or null."},"title":{"type":"string"},"report_type":{"type":["string","null"],"description":"Section/topic type, e.g. 'Bill' or null."},"speaker":{"type":["string","null"],"description":"Primary speaker (member name) or null."},"excerpt":{"type":["string","null"],"description":"Result excerpt snippet or null."},"url":{"type":"string","description":"Absolute, token-bearing URL for this hit's full report — GET it directly to read the transcript (no need to construct the URL). Server-generated from your request token."}}},"description":"Every report for that sitting (TOC)."}}},"description":"Sitting TOC (format=json)."},"text/html":{"schema":{"type":"string"},"description":"Server-rendered TOC (format=html, default)."},"text/plain":{"schema":{"type":"string"},"description":"Machine-readable plain text (format=text)."}}},"404":{"description":"Invalid/revoked token OR unknown/invalid report id — the SAME body for both (identical HTML error page, by design: no enumeration).","content":{"text/html":{"schema":{"type":"string"},"description":"HTML error page."}}},"422":{"description":"Bad parameters (query too long, date not yyyy-mm-dd, bad format, invalid report id). JSON: the error envelope ``{\"error\": {\"code\": \"invalid_parameter\", \"message\": <string>, \"retryable\": false}}``.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"}},"required":["code","message","retryable"]}},"required":["error"]},"description":"Bad parameters."}}},"429":{"description":"Rate limit exhausted. JSON: ``{\"error\": {\"code\": \"rate_limited\", \"message\": \"Rate limit exceeded.\", \"retryable\": true}}``. No Retry-After; apply bounded exponential backoff and retry.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"}},"required":["code","message","retryable"]}},"required":["error"]},"description":"Rate limited."}}},"502":{"description":"Upstream (SPRS) temporarily unavailable (502) or saturated (503). JSON: ``{\"error\": {\"code\": \"upstream_unavailable\", \"message\": <string>, \"retryable\": true}}``; text: a one-line message; html: the static error page. Retry with bounded exponential backoff; no content is fabricated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"}},"required":["code","message","retryable"]}},"required":["error"]},"description":"Upstream unavailable (json)."}}},"503":{"description":"Upstream (SPRS) temporarily unavailable (502) or saturated (503). JSON: ``{\"error\": {\"code\": \"upstream_unavailable\", \"message\": <string>, \"retryable\": true}}``; text: a one-line message; html: the static error page. Retry with bounded exponential backoff; no content is fabricated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"}},"required":["code","message","retryable"]}},"required":["error"]},"description":"Upstream saturated (json)."}}}}}},"/a/{token}":{"get":{"summary":"Launcher Handler","description":"The departure board (spec §4.1). Registered at BOTH \"\" and \"/\"\nso /a/{t} and /a/{t}/ return identical 200s with no redirect\n(RESEARCH OQ3 resolution).","operationId":"launcher_handler_a__token__get","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["html","json","text"],"default":"html"},"description":"Response format: ``html`` (default), ``json`` (structured), or ``text`` (plain)."}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/a/{token}/":{"get":{"summary":"Launcher Handler","description":"The departure board (spec §4.1). Registered at BOTH \"\" and \"/\"\nso /a/{t} and /a/{t}/ return identical 200s with no redirect\n(RESEARCH OQ3 resolution).","operationId":"launcher_handler_a__token___get","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["html","json","text"],"default":"html"},"description":"Response format: ``html`` (default), ``json`` (structured), or ``text`` (plain)."}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/a/{token}/nav/{prefix}":{"get":{"summary":"Nav Ladder","description":"The prefix ladder (spec §4.2) — Blocks A/B/C, depth-5 cap,\nfat-branch skip-level, 422-with-navigation. Index-only, no upstream.","operationId":"nav_ladder_a__token__nav__prefix__get","parameters":[{"name":"prefix","in":"path","required":true,"schema":{"type":"string","title":"Prefix"}},{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["html","json","text"],"default":"html"},"description":"Response format: ``html`` (default), ``json`` (structured), or ``text`` (plain)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/a/{token}/years":{"get":{"summary":"Facet Years","description":"One link per year with sittings, newest first (spec §4.3).","operationId":"facet_years_a__token__years_get","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["html","json","text"],"default":"html"},"description":"Response format: ``html`` (default), ``json`` (structured), or ``text`` (plain)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/a/{token}/year/{year}":{"get":{"summary":"Facet Year","description":"One link per sitting date in a year (spec §4.3). 4-digit year or\n422-with-navigation.","operationId":"facet_year_a__token__year__year__get","parameters":[{"name":"year","in":"path","required":true,"schema":{"type":"string","title":"Year"}},{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["html","json","text"],"default":"html"},"description":"Response format: ``html`` (default), ``json`` (structured), or ``text`` (plain)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/a/{token}/members":{"get":{"summary":"Facet Members","description":"A-Z letter links to /members/{letter} (spec §4.3).","operationId":"facet_members_a__token__members_get","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["html","json","text"],"default":"html"},"description":"Response format: ``html`` (default), ``json`` (structured), or ``text`` (plain)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/a/{token}/members/{letter}":{"get":{"summary":"Facet Member","description":"Member links as finished ?speaker= search URLs (spec §4.3).","operationId":"facet_member_a__token__members__letter__get","parameters":[{"name":"letter","in":"path","required":true,"schema":{"type":"string","title":"Letter"}},{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["html","json","text"],"default":"html"},"description":"Response format: ``html`` (default), ``json`` (structured), or ``text`` (plain)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/a/{token}/bills":{"get":{"summary":"Facet Bills","description":"A-Z letter links to /bills/{letter} (spec §4.3).","operationId":"facet_bills_a__token__bills_get","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["html","json","text"],"default":"html"},"description":"Response format: ``html`` (default), ``json`` (structured), or ``text`` (plain)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/a/{token}/bills/{letter}":{"get":{"summary":"Facet Bill","description":"Bill links as finished ?q= search URLs (spec §4.3).","operationId":"facet_bill_a__token__bills__letter__get","parameters":[{"name":"letter","in":"path","required":true,"schema":{"type":"string","title":"Letter"}},{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["html","json","text"],"default":"html"},"description":"Response format: ``html`` (default), ``json`` (structured), or ``text`` (plain)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}