{"openapi":"3.1.0","info":{"title":"DáilDex API","version":"1.0.0-beta","summary":"Structured Oireachtas records with a source link on every item.","description":"Votes (divisions), parliamentary questions, debate contributions, bills stage by stage, committees, and published public-finance observations, structured with source and coverage metadata. Best-effort beta, no uptime SLA; live data freshness is at /v1/status.\n\n**Authentication** is optional. Anonymous callers get 600 requests/hour per IP. A free API key (`Authorization: Bearer dd_live_...`, create one at https://daildex.com/developers/keys) raises that to 5,000 requests/day. Responses carry `RateLimit-Limit`, `RateLimit-Remaining` and `RateLimit-Reset`; a 429 adds `Retry-After`.\n\n**Pagination:** pass `meta.next_cursor` (or the legacy list routes' `next_cursor`) back as `cursor`. `offset` still works on legacy list routes for one version.\n\n**Updates:** votes, questions and debates are ingested hourly, legislation every 6 hours, members and committees daily. Data responses carry `X-Data-As-Of` and include `meta.data_as_of` when their response has a metadata envelope and the source timestamp is available. `/v1/status` reports freshness for parliamentary feeds and finance datasets.\n\n**Oireachtas records:** Contains Parliamentary information licensed under the Oireachtas (Open Data) PSI Licence. https://www.oireachtas.ie/en/open-data/\n**Finance data:** the publisher, source and licence are listed on each dataset at /v1/datasets; an unspecified source licence is shown as null.","contact":{"email":"support@daildex.com","url":"https://daildex.com/developers"},"termsOfService":"https://daildex.com/developers/terms"},"servers":[{"url":"https://api.daildex.com"}],"tags":[{"name":"Representatives"},{"name":"Divisions"},{"name":"Records"},{"name":"Bills"},{"name":"Committees"},{"name":"Data"},{"name":"Usage"},{"name":"Reference"},{"name":"Webhooks"},{"name":"Dex"}],"paths":{"/v1/dex/balance":{"get":{"tags":["Dex"],"summary":"Get the Dex API balance","security":[{"bearer":[]}],"parameters":[],"responses":{"200":{"description":"USD balance and daily limit","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"API key required"},"403":{"description":"Key not enabled"},"503":{"description":"Dex API unavailable"}}}},"/v1/dex/answers":{"post":{"tags":["Dex"],"summary":"Generate a sourced civic answer","description":"Pilot access requires an enabled API key and a funded balance. Fast costs $0.01, Pro $0.05; web search adds $0.05. Prices are USD before applicable tax. A completed answer is charged once. Failed answers are refunded. Same-key retries replay the encrypted result for 24 hours.","security":[{"bearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":128},"description":"Unique ID for this logical request. Retry with the same key."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["model","question"],"properties":{"model":{"type":"string","enum":["dex-fast","dex-pro"]},"question":{"type":"string","minLength":1,"maxLength":2000},"locale":{"type":"string","enum":["en","ga"],"default":"en"},"web":{"type":"boolean","default":false},"history":{"type":"array","maxItems":4,"items":{"type":"object","additionalProperties":false,"required":["role","content"],"properties":{"role":{"type":"string","enum":["user","assistant"]},"content":{"type":"string","maxLength":2000}}}}}}}}},"responses":{"200":{"description":"Answer, retrieved sources, limitations and usage","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request"},"401":{"description":"API key required"},"402":{"description":"Insufficient credit"},"403":{"description":"Key not enabled"},"409":{"description":"Idempotency conflict, pending, failed or expired"},"429":{"description":"Limit reached"},"503":{"description":"Service unavailable or outcome being reconciled"}}}},"/v1/representatives":{"get":{"summary":"List representatives","description":"Up to 300 members. Defaults to active members.","tags":["Representatives"],"parameters":[{"name":"q","in":"query","required":false,"description":"Case-insensitive substring search. `%` and `_` are matched literally.","schema":{"type":"string","minLength":1,"maxLength":120}},{"name":"chamber","in":"query","required":false,"description":"Filter by chamber.","schema":{"type":"string","enum":["Dáil","Seanad"]}},{"name":"party","in":"query","required":false,"description":"Party name or slug, e.g. `Fianna Fáil` or `fianna-fail`.","schema":{"type":"string","minLength":1,"maxLength":120}},{"name":"constituency","in":"query","required":false,"description":"Constituency name or slug.","schema":{"type":"string","minLength":1,"maxLength":120}},{"name":"status","in":"query","required":false,"description":"Record status filter.","schema":{"default":"active","type":"string","enum":["active","former","all"]}}],"security":[{},{"bearer":[]}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"representatives":{"type":"array","items":{"$ref":"#/components/schemas/Representative"}},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["representatives","meta"]}}}},"400":{"description":"Invalid request. `error.fields` lists each problem, including unknown parameters.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit reached. Wait `Retry-After` seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/representatives/{id}":{"get":{"summary":"Get a representative","description":"Includes a summary of the votes and questions DáilDex holds for them.","tags":["Representatives"],"parameters":[{"name":"id","in":"path","required":true,"description":"Representative id.","schema":{"type":"string"}}],"security":[{},{"bearer":[]}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/RepresentativeDetail"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"]}}}},"400":{"description":"Invalid request. `error.fields` lists each problem, including unknown parameters.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such record.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit reached. Wait `Retry-After` seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/votes":{"get":{"summary":"List per-member vote rows","description":"Newest first. Text fields are truncated to 500 characters; use the detail route for full text.","tags":["Records"],"parameters":[{"name":"q","in":"query","required":false,"description":"Case-insensitive substring search. `%` and `_` are matched literally.","schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"representative","in":"query","required":false,"description":"A representative id, e.g. `jennifer-whitmore` (see /v1/representatives).","schema":{"type":"string","minLength":1,"maxLength":160}},{"name":"chamber","in":"query","required":false,"description":"Filter by chamber.","schema":{"type":"string","enum":["Dáil","Seanad"]}},{"name":"date_start","in":"query","required":false,"description":"Earliest date, inclusive (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"date_end","in":"query","required":false,"description":"Latest date, inclusive (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Page size.","schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"name":"offset","in":"query","required":false,"description":"Legacy offset paging. Prefer `cursor`; the two cannot be combined.","schema":{"default":0,"type":"integer","minimum":0,"maximum":10000}},{"name":"cursor","in":"query","required":false,"description":"Opaque cursor from `next_cursor` in the previous page.","schema":{"type":"string","minLength":1,"maxLength":300}}],"security":[{},{"bearer":[]}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"votes":{"type":"array","items":{"$ref":"#/components/schemas/ActivityItem"}},"limit":{"type":"integer"},"offset":{"type":"integer"},"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["votes","limit","offset","next_cursor","has_more","meta"]}}}},"400":{"description":"Invalid request. `error.fields` lists each problem, including unknown parameters.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit reached. Wait `Retry-After` seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/representatives/{id}/votes":{"get":{"summary":"List per-member vote rows for one representative","tags":["Representatives"],"parameters":[{"name":"id","in":"path","required":true,"description":"Representative id.","schema":{"type":"string"}},{"name":"q","in":"query","required":false,"description":"Case-insensitive substring search. `%` and `_` are matched literally.","schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"chamber","in":"query","required":false,"description":"Filter by chamber.","schema":{"type":"string","enum":["Dáil","Seanad"]}},{"name":"date_start","in":"query","required":false,"description":"Earliest date, inclusive (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"date_end","in":"query","required":false,"description":"Latest date, inclusive (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Page size.","schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"name":"offset","in":"query","required":false,"description":"Legacy offset paging. Prefer `cursor`; the two cannot be combined.","schema":{"default":0,"type":"integer","minimum":0,"maximum":10000}},{"name":"cursor","in":"query","required":false,"description":"Opaque cursor from `next_cursor` in the previous page.","schema":{"type":"string","minLength":1,"maxLength":300}}],"security":[{},{"bearer":[]}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"votes":{"type":"array","items":{"$ref":"#/components/schemas/ActivityItem"}},"limit":{"type":"integer"},"offset":{"type":"integer"},"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["votes","limit","offset","next_cursor","has_more","meta"]}}}},"400":{"description":"Invalid request. `error.fields` lists each problem, including unknown parameters.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such record.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit reached. Wait `Retry-After` seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/questions":{"get":{"summary":"List parliamentary questions","description":"Newest first. Text fields are truncated to 500 characters; use the detail route for full text.","tags":["Records"],"parameters":[{"name":"q","in":"query","required":false,"description":"Case-insensitive substring search. `%` and `_` are matched literally.","schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"representative","in":"query","required":false,"description":"A representative id, e.g. `jennifer-whitmore` (see /v1/representatives).","schema":{"type":"string","minLength":1,"maxLength":160}},{"name":"chamber","in":"query","required":false,"description":"Filter by chamber.","schema":{"type":"string","enum":["Dáil","Seanad"]}},{"name":"date_start","in":"query","required":false,"description":"Earliest date, inclusive (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"date_end","in":"query","required":false,"description":"Latest date, inclusive (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Page size.","schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"name":"offset","in":"query","required":false,"description":"Legacy offset paging. Prefer `cursor`; the two cannot be combined.","schema":{"default":0,"type":"integer","minimum":0,"maximum":10000}},{"name":"cursor","in":"query","required":false,"description":"Opaque cursor from `next_cursor` in the previous page.","schema":{"type":"string","minLength":1,"maxLength":300}}],"security":[{},{"bearer":[]}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"questions":{"type":"array","items":{"$ref":"#/components/schemas/ActivityItem"}},"limit":{"type":"integer"},"offset":{"type":"integer"},"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["questions","limit","offset","next_cursor","has_more","meta"]}}}},"400":{"description":"Invalid request. `error.fields` lists each problem, including unknown parameters.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit reached. Wait `Retry-After` seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/representatives/{id}/questions":{"get":{"summary":"List parliamentary questions for one representative","tags":["Representatives"],"parameters":[{"name":"id","in":"path","required":true,"description":"Representative id.","schema":{"type":"string"}},{"name":"q","in":"query","required":false,"description":"Case-insensitive substring search. `%` and `_` are matched literally.","schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"chamber","in":"query","required":false,"description":"Filter by chamber.","schema":{"type":"string","enum":["Dáil","Seanad"]}},{"name":"date_start","in":"query","required":false,"description":"Earliest date, inclusive (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"date_end","in":"query","required":false,"description":"Latest date, inclusive (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Page size.","schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"name":"offset","in":"query","required":false,"description":"Legacy offset paging. Prefer `cursor`; the two cannot be combined.","schema":{"default":0,"type":"integer","minimum":0,"maximum":10000}},{"name":"cursor","in":"query","required":false,"description":"Opaque cursor from `next_cursor` in the previous page.","schema":{"type":"string","minLength":1,"maxLength":300}}],"security":[{},{"bearer":[]}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"questions":{"type":"array","items":{"$ref":"#/components/schemas/ActivityItem"}},"limit":{"type":"integer"},"offset":{"type":"integer"},"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["questions","limit","offset","next_cursor","has_more","meta"]}}}},"400":{"description":"Invalid request. `error.fields` lists each problem, including unknown parameters.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such record.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit reached. Wait `Retry-After` seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/speeches":{"get":{"summary":"List debate contributions","description":"Newest first. Text fields are truncated to 500 characters; use the detail route for full text.","tags":["Records"],"parameters":[{"name":"q","in":"query","required":false,"description":"Case-insensitive substring search. `%` and `_` are matched literally.","schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"representative","in":"query","required":false,"description":"A representative id, e.g. `jennifer-whitmore` (see /v1/representatives).","schema":{"type":"string","minLength":1,"maxLength":160}},{"name":"chamber","in":"query","required":false,"description":"Filter by chamber.","schema":{"type":"string","enum":["Dáil","Seanad"]}},{"name":"date_start","in":"query","required":false,"description":"Earliest date, inclusive (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"date_end","in":"query","required":false,"description":"Latest date, inclusive (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Page size.","schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"name":"offset","in":"query","required":false,"description":"Legacy offset paging. Prefer `cursor`; the two cannot be combined.","schema":{"default":0,"type":"integer","minimum":0,"maximum":10000}},{"name":"cursor","in":"query","required":false,"description":"Opaque cursor from `next_cursor` in the previous page.","schema":{"type":"string","minLength":1,"maxLength":300}}],"security":[{},{"bearer":[]}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"speeches":{"type":"array","items":{"$ref":"#/components/schemas/ActivityItem"}},"limit":{"type":"integer"},"offset":{"type":"integer"},"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["speeches","limit","offset","next_cursor","has_more","meta"]}}}},"400":{"description":"Invalid request. `error.fields` lists each problem, including unknown parameters.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit reached. Wait `Retry-After` seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/representatives/{id}/speeches":{"get":{"summary":"List debate contributions for one representative","tags":["Representatives"],"parameters":[{"name":"id","in":"path","required":true,"description":"Representative id.","schema":{"type":"string"}},{"name":"q","in":"query","required":false,"description":"Case-insensitive substring search. `%` and `_` are matched literally.","schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"chamber","in":"query","required":false,"description":"Filter by chamber.","schema":{"type":"string","enum":["Dáil","Seanad"]}},{"name":"date_start","in":"query","required":false,"description":"Earliest date, inclusive (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"date_end","in":"query","required":false,"description":"Latest date, inclusive (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Page size.","schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"name":"offset","in":"query","required":false,"description":"Legacy offset paging. Prefer `cursor`; the two cannot be combined.","schema":{"default":0,"type":"integer","minimum":0,"maximum":10000}},{"name":"cursor","in":"query","required":false,"description":"Opaque cursor from `next_cursor` in the previous page.","schema":{"type":"string","minLength":1,"maxLength":300}}],"security":[{},{"bearer":[]}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"speeches":{"type":"array","items":{"$ref":"#/components/schemas/ActivityItem"}},"limit":{"type":"integer"},"offset":{"type":"integer"},"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["speeches","limit","offset","next_cursor","has_more","meta"]}}}},"400":{"description":"Invalid request. `error.fields` lists each problem, including unknown parameters.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such record.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit reached. Wait `Retry-After` seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/divisions":{"get":{"summary":"List divisions","description":"One row per division, with outcome and Tá/Níl/Staon tallies.","tags":["Divisions"],"parameters":[{"name":"q","in":"query","required":false,"description":"Case-insensitive substring search. `%` and `_` are matched literally.","schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"representative","in":"query","required":false,"description":"A representative id, e.g. `jennifer-whitmore` (see /v1/representatives).","schema":{"type":"string","minLength":1,"maxLength":160}},{"name":"chamber","in":"query","required":false,"description":"Filter by chamber.","schema":{"type":"string","enum":["Dáil","Seanad"]}},{"name":"outcome","in":"query","required":false,"description":"Division outcome, e.g. `Carried` or `Lost` (case-insensitive).","schema":{"type":"string","minLength":1,"maxLength":40}},{"name":"date_start","in":"query","required":false,"description":"Earliest date, inclusive (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"date_end","in":"query","required":false,"description":"Latest date, inclusive (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Page size.","schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"Opaque cursor from `next_cursor` in the previous page.","schema":{"type":"string","minLength":1,"maxLength":300}}],"security":[{},{"bearer":[]}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Division"}},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"]}}}},"400":{"description":"Invalid request. `error.fields` lists each problem, including unknown parameters.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit reached. Wait `Retry-After` seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/divisions/{id}":{"get":{"summary":"Get a division","description":"Adds the party breakdown; `?include=members` adds every member's vote.","tags":["Divisions"],"parameters":[{"name":"id","in":"path","required":true,"description":"Division id (UUID).","schema":{"type":"string"}},{"name":"include","in":"query","required":false,"description":"`members` adds each member's vote.","schema":{"type":"string","enum":["members"]}}],"security":[{},{"bearer":[]}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/DivisionDetail"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"]}}}},"400":{"description":"Invalid request. `error.fields` lists each problem, including unknown parameters.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such record.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit reached. Wait `Retry-After` seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/questions/{id}":{"get":{"summary":"Get a parliamentary question","description":"Full question text and, when the department has replied, the written answer as plain text.","tags":["Records"],"parameters":[{"name":"id","in":"path","required":true,"description":"Question id (UUID) from /v1/questions.","schema":{"type":"string"}}],"security":[{},{"bearer":[]}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/QuestionDetail"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"]}}}},"400":{"description":"Invalid request. `error.fields` lists each problem, including unknown parameters.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such record.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit reached. Wait `Retry-After` seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/speeches/{id}":{"get":{"summary":"Get a debate contribution","description":"Full text, with the debate section heading.","tags":["Records"],"parameters":[{"name":"id","in":"path","required":true,"description":"Contribution id (UUID) from /v1/speeches.","schema":{"type":"string"}}],"security":[{},{"bearer":[]}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/SpeechDetail"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"]}}}},"400":{"description":"Invalid request. `error.fields` lists each problem, including unknown parameters.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such record.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit reached. Wait `Retry-After` seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/legislation":{"get":{"summary":"List bills as activity items","description":"Legacy shape. Prefer /v1/bills.","tags":["Bills"],"parameters":[{"name":"q","in":"query","required":false,"description":"Case-insensitive substring search. `%` and `_` are matched literally.","schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"date_start","in":"query","required":false,"description":"Earliest date, inclusive (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"date_end","in":"query","required":false,"description":"Latest date, inclusive (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Page size.","schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"name":"offset","in":"query","required":false,"description":"Legacy offset paging. Prefer `cursor`; the two cannot be combined.","schema":{"default":0,"type":"integer","minimum":0,"maximum":10000}},{"name":"cursor","in":"query","required":false,"description":"Opaque cursor from `next_cursor` in the previous page.","schema":{"type":"string","minLength":1,"maxLength":300}}],"security":[{},{"bearer":[]}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"legislation":{"type":"array","items":{"$ref":"#/components/schemas/ActivityItem"}},"limit":{"type":"integer"},"offset":{"type":"integer"},"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["legislation","limit","offset","next_cursor","has_more","meta"]}}}},"400":{"description":"Invalid request. `error.fields` lists each problem, including unknown parameters.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit reached. Wait `Retry-After` seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/activity":{"get":{"summary":"Cross-record activity feed","description":"Votes, questions, speeches and legislation on one timeline.","tags":["Records"],"parameters":[{"name":"q","in":"query","required":false,"description":"Case-insensitive substring search. `%` and `_` are matched literally.","schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"representative","in":"query","required":false,"description":"A representative id, e.g. `jennifer-whitmore` (see /v1/representatives).","schema":{"type":"string","minLength":1,"maxLength":160}},{"name":"chamber","in":"query","required":false,"description":"Filter by chamber.","schema":{"type":"string","enum":["Dáil","Seanad"]}},{"name":"date_start","in":"query","required":false,"description":"Earliest date, inclusive (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"date_end","in":"query","required":false,"description":"Latest date, inclusive (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Page size.","schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"name":"offset","in":"query","required":false,"description":"Legacy offset paging. Prefer `cursor`; the two cannot be combined.","schema":{"default":0,"type":"integer","minimum":0,"maximum":10000}},{"name":"cursor","in":"query","required":false,"description":"Opaque cursor from `next_cursor` in the previous page.","schema":{"type":"string","minLength":1,"maxLength":300}},{"name":"type","in":"query","required":false,"description":"Restrict the activity feed to one record type.","schema":{"type":"string","enum":["vote","question","speech","legislation"]}}],"security":[{},{"bearer":[]}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ActivityItem"}},"limit":{"type":"integer"},"offset":{"type":"integer"},"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["items","limit","offset","next_cursor","has_more","meta"]}}}},"400":{"description":"Invalid request. `error.fields` lists each problem, including unknown parameters.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit reached. Wait `Retry-After` seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/bills":{"get":{"summary":"List bills","tags":["Bills"],"parameters":[{"name":"q","in":"query","required":false,"description":"Case-insensitive substring search. `%` and `_` are matched literally.","schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"year","in":"query","required":false,"description":"Four-digit bill year.","schema":{"type":"string","pattern":"^\\d{4}$"}},{"name":"status","in":"query","required":false,"description":"Record status filter.","schema":{"type":"string","minLength":1,"maxLength":60}},{"name":"stage","in":"query","required":false,"description":"Bills whose current stage contains this text, e.g. `committee` or `report`.","schema":{"type":"string","minLength":1,"maxLength":80}},{"name":"date_start","in":"query","required":false,"description":"Earliest date, inclusive (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"date_end","in":"query","required":false,"description":"Latest date, inclusive (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Page size.","schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"Opaque cursor from `next_cursor` in the previous page.","schema":{"type":"string","minLength":1,"maxLength":300}}],"security":[{},{"bearer":[]}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Bill"}},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"]}}}},"400":{"description":"Invalid request. `error.fields` lists each problem, including unknown parameters.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit reached. Wait `Retry-After` seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/bills/movements":{"get":{"summary":"Bills that moved stage","description":"Stage changes DáilDex observed, newest first. `date_start` and `date_end` bound the day the move was seen.","tags":["Bills"],"parameters":[{"name":"date_start","in":"query","required":false,"description":"Earliest date, inclusive (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"date_end","in":"query","required":false,"description":"Latest date, inclusive (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Page size.","schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"Opaque cursor from `next_cursor` in the previous page.","schema":{"type":"string","minLength":1,"maxLength":300}}],"security":[{},{"bearer":[]}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/BillMovementItem"}},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"]}}}},"400":{"description":"Invalid request. `error.fields` lists each problem, including unknown parameters.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit reached. Wait `Retry-After` seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/bills/{year}/{number}":{"get":{"summary":"Get a bill","description":"Every stage with its House, date and outcome, the published amendment lists, observed stage changes, sponsors, linked debates and documents.","tags":["Bills"],"parameters":[{"name":"year","in":"path","required":true,"description":"Four-digit year, e.g. 2026.","schema":{"type":"string"}},{"name":"number","in":"path","required":true,"description":"Bill number within the year.","schema":{"type":"string"}}],"security":[{},{"bearer":[]}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/BillDetail"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"]}}}},"400":{"description":"Invalid request. `error.fields` lists each problem, including unknown parameters.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such record.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit reached. Wait `Retry-After` seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/committees":{"get":{"summary":"List committees","description":"Committees of the Dáil, Seanad and Oireachtas with their current member counts. Defaults to the sitting Dáil and Seanad; `status=all` adds earlier ones. Membership comes from the Oireachtas member records.","tags":["Committees"],"parameters":[{"name":"q","in":"query","required":false,"description":"Case-insensitive substring search. `%` and `_` are matched literally.","schema":{"type":"string","minLength":1,"maxLength":120}},{"name":"house","in":"query","required":false,"description":"Filter by House.","schema":{"type":"string","enum":["Dáil","Seanad"]}},{"name":"house_no","in":"query","required":false,"description":"Dáil or Seanad number, e.g. `34` for the 34th Dáil.","schema":{"type":"integer","minimum":1,"maximum":200}},{"name":"type","in":"query","required":false,"description":"Restrict the activity feed to one record type.","schema":{"type":"string","minLength":1,"maxLength":80}},{"name":"status","in":"query","required":false,"description":"Record status filter.","schema":{"default":"current","type":"string","enum":["current","all"]}},{"name":"representative","in":"query","required":false,"description":"A representative id, e.g. `jennifer-whitmore` (see /v1/representatives).","schema":{"type":"string","minLength":1,"maxLength":160}}],"security":[{},{"bearer":[]}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Committee"}},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"]}}}},"400":{"description":"Invalid request. `error.fields` lists each problem, including unknown parameters.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit reached. Wait `Retry-After` seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/committees/{id}":{"get":{"summary":"Get a committee","description":"Members with their offices and dates, and recent hearings for which DáilDex holds contributions.","tags":["Committees"],"parameters":[{"name":"id","in":"path","required":true,"description":"Committee id from /v1/committees, e.g. `dail-34-committee_of_public_accounts`.","schema":{"type":"string"}}],"security":[{},{"bearer":[]}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/CommitteeDetail"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"]}}}},"400":{"description":"Invalid request. `error.fields` lists each problem, including unknown parameters.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such record.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit reached. Wait `Retry-After` seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/representatives/{id}/committees":{"get":{"summary":"Committees a representative sits or sat on","tags":["Representatives"],"parameters":[{"name":"id","in":"path","required":true,"description":"Representative id.","schema":{"type":"string"}},{"name":"q","in":"query","required":false,"description":"Case-insensitive substring search. `%` and `_` are matched literally.","schema":{"type":"string","minLength":1,"maxLength":120}},{"name":"house","in":"query","required":false,"description":"Filter by House.","schema":{"type":"string","enum":["Dáil","Seanad"]}},{"name":"house_no","in":"query","required":false,"description":"Dáil or Seanad number, e.g. `34` for the 34th Dáil.","schema":{"type":"integer","minimum":1,"maximum":200}},{"name":"type","in":"query","required":false,"description":"Restrict the activity feed to one record type.","schema":{"type":"string","minLength":1,"maxLength":80}},{"name":"status","in":"query","required":false,"description":"Record status filter.","schema":{"default":"current","type":"string","enum":["current","all"]}}],"security":[{},{"bearer":[]}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Committee"}},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"]}}}},"400":{"description":"Invalid request. `error.fields` lists each problem, including unknown parameters.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such record.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit reached. Wait `Retry-After` seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/representatives/{id}/voting-record":{"get":{"summary":"How a representative has voted over time","description":"Votes grouped by year, month or Dáil: divisions held while they sat, how many they voted in, Tá/Níl/Staon, absences and how often they voted with their party's majority. Covers every Dáil DáilDex holds votes for.","tags":["Representatives"],"parameters":[{"name":"id","in":"path","required":true,"description":"Representative id.","schema":{"type":"string"}},{"name":"group_by","in":"query","required":false,"description":"Group the record by `year`, `month` or Dáil (`house`).","schema":{"default":"year","type":"string","enum":["year","month","house"]}},{"name":"date_start","in":"query","required":false,"description":"Earliest date, inclusive (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"date_end","in":"query","required":false,"description":"Latest date, inclusive (YYYY-MM-DD).","schema":{"type":"string","format":"date"}}],"security":[{},{"bearer":[]}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/VotingRecord"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"]}}}},"400":{"description":"Invalid request. `error.fields` lists each problem, including unknown parameters.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such record.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit reached. Wait `Retry-After` seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/status":{"get":{"summary":"Data freshness and service status","description":"How recently parliamentary feeds and public-finance datasets were checked, whether the official Oireachtas API is reachable and unchanged, and the combined overall state. The human version is at https://daildex.com/status.","tags":["Reference"],"security":[{},{"bearer":[]}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Status"}}}},"400":{"description":"Invalid request. `error.fields` lists each problem, including unknown parameters.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit reached. Wait `Retry-After` seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/parties":{"get":{"summary":"List parties","description":"Parties of active members, with member counts.","tags":["Reference"],"security":[{},{"bearer":[]}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Party"}},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"]}}}},"400":{"description":"Invalid request. `error.fields` lists each problem, including unknown parameters.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit reached. Wait `Retry-After` seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/constituencies":{"get":{"summary":"List constituencies","tags":["Reference"],"security":[{},{"bearer":[]}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Constituency"}},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"]}}}},"400":{"description":"Invalid request. `error.fields` lists each problem, including unknown parameters.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit reached. Wait `Retry-After` seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/datasets":{"get":{"summary":"List public-finance datasets","description":"Source, licence, coverage, publication and freshness information. Pending and quarantined observations are not published.","tags":["Data"],"security":[{},{"bearer":[]}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/FinanceDataset"}},"meta":{"type":"object","properties":{"count":{"type":"integer"},"fetched_at":{"type":"string","format":"date-time"},"data_as_of":{"type":"string","format":"date-time","nullable":true}},"required":["count","fetched_at"]}},"required":["data","meta"]}}}},"400":{"description":"Invalid request. `error.fields` lists each problem, including unknown parameters.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit reached. Wait `Retry-After` seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/datasets/{key}":{"get":{"summary":"Get a public-finance dataset","tags":["Data"],"parameters":[{"name":"key","in":"path","required":true,"description":"Dataset key from /v1/datasets.","schema":{"type":"string"}}],"security":[{},{"bearer":[]}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/FinanceDataset"},"meta":{"type":"object","properties":{"fetched_at":{"type":"string","format":"date-time"},"data_as_of":{"type":"string","format":"date-time","nullable":true}},"required":["fetched_at"]}},"required":["data","meta"]}}}},"400":{"description":"Invalid request. `error.fields` lists each problem, including unknown parameters.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such record.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit reached. Wait `Retry-After` seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/datasets/{key}/observations":{"get":{"summary":"List published observations for a dataset","description":"Only published observations are returned. Every row keeps its metric basis, period, coverage, source provenance and revision number.","tags":["Data"],"parameters":[{"name":"key","in":"path","required":true,"description":"Dataset key from /v1/datasets.","schema":{"type":"string"}},{"name":"metric","in":"query","required":false,"description":"Filter by the source metric key.","schema":{"type":"string","minLength":1,"maxLength":120}},{"name":"entity","in":"query","required":false,"description":"Filter by the source entity key.","schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"basis","in":"query","required":false,"description":"Filter by accounting basis, such as `forecast`, `reported` or `audited_actual`.","schema":{"type":"string","enum":["reported","provisional_outturn","audited_actual","allocation","forecast","profile","contract_awarded","purchase_order","payment","allowance_paid"]}},{"name":"date_start","in":"query","required":false,"description":"Earliest date, inclusive (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"date_end","in":"query","required":false,"description":"Latest date, inclusive (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Page size.","schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"name":"offset","in":"query","required":false,"description":"Legacy offset paging. Prefer `cursor`; the two cannot be combined.","schema":{"default":0,"type":"integer","minimum":0,"maximum":10000}},{"name":"cursor","in":"query","required":false,"description":"Opaque cursor from `next_cursor` in the previous page.","schema":{"type":"string","minLength":1,"maxLength":300}}],"security":[{},{"bearer":[]}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/FinanceObservation"}},"meta":{"type":"object","properties":{"count":{"type":"integer"},"limit":{"type":"integer"},"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"},"fetched_at":{"type":"string","format":"date-time"},"dataset":{"$ref":"#/components/schemas/FinanceDataset"},"data_as_of":{"type":"string","format":"date-time","nullable":true}},"required":["count","limit","next_cursor","has_more","fetched_at","dataset"]}},"required":["data","meta"]}}}},"400":{"description":"Invalid request. `error.fields` lists each problem, including unknown parameters.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such record.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit reached. Wait `Retry-After` seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/webhooks":{"get":{"summary":"List your webhooks","tags":["Webhooks"],"security":[{"bearer":[]}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Webhook"}}},"required":["data"]}}}},"400":{"description":"Invalid request. `error.fields` lists each problem, including unknown parameters.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"A valid API key is required.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit reached. Wait `Retry-After` seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"Create a webhook","description":"Events: division.created, division.corrected, question.created, question.revised, speech.created, speech.revised, bill.stage_changed. At most 5 per key. Deliveries are POSTed as JSON with `X-DailDex-Signature: sha256=<HMAC-SHA256 of timestamp + \".\" + raw body with the secret>`, retried with backoff, and the webhook is disabled after repeated failures.","tags":["Webhooks"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateWebhook"}}}},"security":[{"bearer":[]}],"responses":{"201":{"description":"OK","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/WebhookCreated"}},"required":["data"]}}}},"400":{"description":"Invalid request. `error.fields` lists each problem, including unknown parameters.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"A valid API key is required.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit reached. Wait `Retry-After` seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/webhooks/{id}":{"delete":{"summary":"Delete a webhook","tags":["Webhooks"],"parameters":[{"name":"id","in":"path","required":true,"description":"Webhook id.","schema":{"type":"string"}}],"security":[{"bearer":[]}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"deleted":{"type":"boolean"}},"required":["deleted"]}},"required":["data"]}}}},"400":{"description":"Invalid request. `error.fields` lists each problem, including unknown parameters.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"A valid API key is required.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such record.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit reached. Wait `Retry-After` seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/webhooks/{id}/deliveries":{"get":{"summary":"Recent deliveries for a webhook","tags":["Webhooks"],"parameters":[{"name":"id","in":"path","required":true,"description":"Webhook id.","schema":{"type":"string"}}],"security":[{"bearer":[]}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/WebhookDelivery"}}},"required":["data"]}}}},"400":{"description":"Invalid request. `error.fields` lists each problem, including unknown parameters.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"A valid API key is required.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such record.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit reached. Wait `Retry-After` seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/usage":{"get":{"summary":"Show your API key usage","description":"Aggregated daily request counts and latency by normalized route for the last 30 days. Request bodies, query values, IP addresses and record IDs are not retained.","tags":["Usage"],"security":[{"bearer":[]}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ApiUsage"}},"required":["data"]}}}},"400":{"description":"Invalid request. `error.fields` lists each problem, including unknown parameters.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"A valid API key is required.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit reached. Wait `Retry-After` seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed in the current window."},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window."},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Licence":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"},"attribution":{"type":"string"}},"required":["name","url","attribution"]},"Meta":{"type":"object","properties":{"count":{"type":"integer"},"limit":{"type":"integer"},"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"},"licence":{"$ref":"#/components/schemas/Licence"},"fetched_at":{"type":"string","format":"date-time"},"data_as_of":{"type":"string","format":"date-time","description":"When the source data behind this response was last successfully checked or synced."}},"required":["count","limit","next_cursor","has_more","licence","fetched_at"]},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["INVALID_REQUEST","UNAUTHORIZED","NOT_FOUND","RATE_LIMITED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"fields":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"issue":{"type":"string"}},"required":["field","issue"]}}},"required":["code","message"]}},"required":["error"]},"RepresentativeSummary":{"type":"object","properties":{"id":{"type":"string","example":"jennifer-whitmore"},"name":{"type":"string"},"area":{"type":"string"},"party":{"type":"string"},"chamber":{"type":"string","enum":["Dáil","Seanad"]},"role":{"type":"string","enum":["TD","Senator"]}},"required":["id","name","area","party","chamber","role"]},"Representative":{"type":"object","properties":{"id":{"type":"string","example":"jennifer-whitmore"},"name":{"type":"string"},"area":{"type":"string"},"party":{"type":"string"},"chamber":{"type":"string","enum":["Dáil","Seanad"]},"role":{"type":"string","enum":["TD","Senator"]}},"required":["id","name","area","party","chamber","role"]},"RepresentativeDetail":{"type":"object","properties":{"id":{"type":"string","example":"jennifer-whitmore"},"name":{"type":"string"},"area":{"type":"string"},"party":{"type":"string"},"chamber":{"type":"string","enum":["Dáil","Seanad"]},"role":{"type":"string","enum":["TD","Senator"]},"status":{"type":"string","enum":["active","former"]},"firstElected":{"type":"string","format":"date","nullable":true},"sourceUrl":{"type":"string","format":"uri","nullable":true},"record":{"type":"object","properties":{"divisions":{"type":"integer"},"votedIn":{"type":"integer"},"ta":{"type":"integer"},"nil":{"type":"integer"},"staon":{"type":"integer"},"questions":{"type":"integer"},"since":{"type":"string","format":"date","nullable":true},"questionsSince":{"type":"string","format":"date","nullable":true}},"required":["divisions","votedIn","ta","nil","staon","questions","since","questionsSince"]}},"required":["id","name","area","party","chamber","role","status","firstElected","sourceUrl","record"]},"VoteContext":{"type":"object","properties":{"kind":{"type":"string","enum":["bill","policy_motion","motion","procedural","confidence","financial","statutory","constitutional","other","unknown"]},"stage":{"type":"string","enum":["first","second","committee","report","final","combined"],"nullable":true},"amendment":{"type":"boolean"},"question":{"type":"string","description":"The exact question when supplied, not an inferred policy position.","nullable":true},"basis":{"type":"string","enum":["official_wording","reviewed","unclassified"],"description":"DáilDex interpretation of the official wording; reviewed means an editorial correction."}},"required":["kind","stage","amendment","question","basis"]},"ActivityItem":{"type":"object","properties":{"id":{"type":"string","description":"Unique per row. For votes: `<divisionId>:<representativeId>`."},"type":{"type":"string","enum":["vote","question","speech","legislation"]},"date":{"type":"string","format":"date","nullable":true},"title":{"type":"string"},"summary":{"type":"string","description":"Truncated to 500 characters. Use the detail routes for full text.","nullable":true},"sourceUrl":{"type":"string","format":"uri"},"representative":{"$ref":"#/components/schemas/RepresentativeSummary","nullable":true},"participation":{"type":"string","description":"`Tá`, `Níl`, `Staon`, `asked` or `spoke`.","nullable":true},"divisionId":{"type":"string","format":"uuid","nullable":true},"voteContext":{"$ref":"#/components/schemas/VoteContext","nullable":true}},"required":["id","type","date","title","summary","sourceUrl","representative","participation","divisionId","voteContext"]},"Division":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"date":{"type":"string","format":"date"},"datetime":{"type":"string","format":"date-time","nullable":true},"house":{"type":"string","enum":["Dáil","Seanad"]},"title":{"type":"string"},"debate":{"type":"string","nullable":true},"context":{"$ref":"#/components/schemas/VoteContext"},"outcome":{"type":"string","nullable":true},"tallies":{"type":"object","properties":{"ta":{"type":"integer"},"nil":{"type":"integer"},"staon":{"type":"integer"}},"required":["ta","nil","staon"]},"tellers":{"type":"string","nullable":true},"sourceUrl":{"type":"string","format":"uri"},"debateUrl":{"type":"string","format":"uri","nullable":true}},"required":["id","date","datetime","house","title","debate","context","outcome","tallies","tellers","sourceUrl","debateUrl"]},"DivisionDetail":{"allOf":[{"$ref":"#/components/schemas/Division"},{"type":"object","properties":{"partyBreakdown":{"type":"array","items":{"type":"object","properties":{"party":{"type":"string"},"ta":{"type":"integer"},"nil":{"type":"integer"},"staon":{"type":"integer"}},"required":["party","ta","nil","staon"]}},"partyBasis":{"type":"string","enum":["at_vote","current_fallback"],"description":"at_vote: parties as on the division date. current_fallback: some members' party history is missing, so their current party is shown."},"members":{"type":"array","items":{"type":"object","properties":{"representative":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"party":{"type":"string"},"area":{"type":"string"}},"required":["id","name","party","area"]},"vote":{"type":"string","nullable":true}},"required":["representative","vote"]}}},"required":["partyBreakdown","partyBasis"]}]},"QuestionDetail":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"date":{"type":"string","format":"date"},"number":{"type":"integer","nullable":true},"type":{"type":"string","nullable":true},"title":{"type":"string"},"department":{"type":"string","nullable":true},"question":{"type":"string"},"answer":{"type":"string","nullable":true},"asker":{"$ref":"#/components/schemas/RepresentativeSummary"},"sourceUrl":{"type":"string","format":"uri"},"revised":{"type":"boolean","description":"True once the official record of this question has been corrected."},"supersededId":{"type":"string","format":"uuid","description":"Present when the id requested was a pre-correction id; id is the stable current one."}},"required":["revised"]},"SpeechDetail":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"date":{"type":"string","format":"date"},"debate":{"type":"string"},"section":{"type":"string","nullable":true},"text":{"type":"string"},"speaker":{"$ref":"#/components/schemas/RepresentativeSummary"},"sourceUrl":{"type":"string","format":"uri"},"revised":{"type":"boolean","description":"True once the official record of this speech has been corrected."},"supersededId":{"type":"string","format":"uuid","description":"Present when the id requested was a pre-correction id; id is the stable current one."}},"required":["revised"]},"Bill":{"type":"object","properties":{"id":{"type":"string","example":"2026/42"},"year":{"type":"string"},"number":{"type":"string"},"title":{"type":"string"},"longTitle":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"currentStage":{"type":"string","nullable":true},"currentStageDate":{"type":"string","format":"date","nullable":true},"sourceUrl":{"type":"string","format":"uri"}},"required":["id","year","number","title","longTitle","status","source","currentStage","currentStageDate","sourceUrl"]},"BillDetail":{"allOf":[{"$ref":"#/components/schemas/Bill"},{"type":"object","properties":{"sponsors":{"type":"array","items":{"type":"string"}},"stages":{"type":"array","items":{"$ref":"#/components/schemas/BillStage"}},"amendments":{"type":"array","items":{"$ref":"#/components/schemas/BillAmendmentList"}},"history":{"type":"array","items":{"$ref":"#/components/schemas/BillMovement"}},"debates":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"date":{"type":"string","format":"date","nullable":true},"url":{"type":"string","format":"uri","nullable":true}},"required":["label","date","url"]}},"documents":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"type":{"type":"string"},"language":{"type":"string","nullable":true},"pdfUrl":{"type":"string","nullable":true},"xmlUrl":{"type":"string","nullable":true}},"required":["label","type","language","pdfUrl","xmlUrl"]}}},"required":["sponsors","stages","amendments","history","debates","documents"]}]},"BillStage":{"type":"object","properties":{"stage":{"type":"string","example":"Committee Stage"},"stageNo":{"type":"integer","nullable":true},"house":{"type":"string","example":"34th Dáil","nullable":true},"chamber":{"type":"string","enum":["Dáil","Seanad"],"nullable":true},"date":{"type":"string","format":"date","nullable":true},"completed":{"type":"boolean","nullable":true},"outcome":{"type":"string","nullable":true}},"required":["stage","stageNo","house","chamber","date","completed","outcome"]},"BillAmendmentList":{"type":"object","properties":{"label":{"type":"string"},"stage":{"type":"string","nullable":true},"stageNo":{"type":"integer","nullable":true},"chamber":{"type":"string","nullable":true},"date":{"type":"string","format":"date","nullable":true},"type":{"type":"string","example":"numberedList","nullable":true},"pdfUrl":{"type":"string","format":"uri","nullable":true},"xmlUrl":{"type":"string","format":"uri","nullable":true}},"required":["label","stage","stageNo","chamber","date","type","pdfUrl","xmlUrl"]},"BillMovement":{"type":"object","properties":{"from":{"type":"string","nullable":true},"to":{"type":"string"},"stageDate":{"type":"string","format":"date","nullable":true},"observedAt":{"type":"string","format":"date-time","description":"When DáilDex saw the bill at the new stage."}},"required":["from","to","stageDate","observedAt"]},"BillMovementItem":{"type":"object","properties":{"bill":{"type":"object","properties":{"id":{"type":"string","example":"2026/42"},"year":{"type":"string"},"number":{"type":"string"},"title":{"type":"string"},"sourceUrl":{"type":"string","format":"uri"}},"required":["id","year","number","title","sourceUrl"]},"from":{"type":"string","nullable":true},"to":{"type":"string"},"stageDate":{"type":"string","format":"date","nullable":true},"observedAt":{"type":"string","format":"date-time"}},"required":["bill","from","to","stageDate","observedAt"]},"Committee":{"type":"object","properties":{"id":{"type":"string","example":"dail-34-committee_of_public_accounts","description":"`<house>-<houseNo>-<slug>`."},"name":{"type":"string"},"nameGa":{"type":"string","nullable":true},"house":{"type":"string","enum":["Dáil","Seanad"]},"houseNo":{"type":"integer","nullable":true},"types":{"type":"array","items":{"type":"string"}},"expiry":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"current":{"type":"boolean"},"startDate":{"type":"string","format":"date","nullable":true},"endDate":{"type":"string","format":"date","nullable":true},"members":{"type":"integer","description":"Current members."},"sourceUrl":{"type":"string","format":"uri"}},"required":["id","name","nameGa","house","houseNo","types","expiry","status","current","startDate","endDate","members","sourceUrl"]},"CommitteeDetail":{"allOf":[{"$ref":"#/components/schemas/Committee"},{"type":"object","properties":{"membership":{"type":"array","items":{"type":"object","properties":{"representative":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"party":{"type":"string"},"area":{"type":"string"},"chamber":{"type":"string","enum":["Dáil","Seanad"]}},"required":["id","name","party","area","chamber"]},"role":{"type":"string","description":"Chair, vice-chair and other offices, in the Oireachtas's wording (often Irish).","nullable":true},"status":{"type":"string","nullable":true},"since":{"type":"string","format":"date"},"until":{"type":"string","format":"date","nullable":true}},"required":["representative","role","status","since","until"]}},"hearings":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"title":{"type":"string","nullable":true},"sections":{"type":"integer"},"speakers":{"type":"integer"},"url":{"type":"string","format":"uri","nullable":true}},"required":["date","title","sections","speakers","url"]}}},"required":["membership","hearings"]}]},"VotingPeriod":{"type":"object","properties":{"period":{"type":"string","example":"2025"},"eligible":{"type":"integer","description":"Divisions held in this period while the member held a seat."},"voted":{"type":"integer"},"ta":{"type":"integer"},"nil":{"type":"integer"},"staon":{"type":"integer"},"absent":{"type":"integer"},"participation":{"type":"number","description":"voted / eligible, 0 to 1."},"partyCompared":{"type":"integer","description":"Votes cast where the member's party, as it stood that day, had a clear majority among the others who voted."},"withParty":{"type":"integer"},"withPartyRate":{"type":"number","nullable":true}},"required":["period","eligible","voted","ta","nil","staon","absent","participation","partyCompared","withParty","withPartyRate"]},"VotingRecord":{"type":"object","properties":{"representative":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"party":{"type":"string"},"chamber":{"type":"string","enum":["Dáil","Seanad"]},"status":{"type":"string","enum":["active","former"]}},"required":["id","name","party","chamber","status"]},"groupBy":{"type":"string","enum":["year","month","house"]},"eligibilityKnown":{"type":"boolean","description":"False when the member's dated terms are not stored; eligibility is then limited to divisions they voted in."},"terms":{"type":"array","items":{"type":"object","properties":{"house":{"type":"string","nullable":true},"start":{"type":"string","format":"date"},"end":{"type":"string","format":"date","nullable":true},"area":{"type":"string","nullable":true}},"required":["house","start","end","area"]}},"parties":{"type":"array","items":{"type":"object","properties":{"party":{"type":"string"},"start":{"type":"string","format":"date"},"end":{"type":"string","format":"date","nullable":true}},"required":["party","start","end"]}},"periods":{"type":"array","items":{"$ref":"#/components/schemas/VotingPeriod"}},"totals":{"type":"object","properties":{"eligible":{"type":"integer"},"voted":{"type":"integer"},"ta":{"type":"integer"},"nil":{"type":"integer"},"staon":{"type":"integer"},"absent":{"type":"integer"},"participation":{"type":"number"},"partyCompared":{"type":"integer"},"withParty":{"type":"integer"},"withPartyRate":{"type":"number","nullable":true}},"required":["eligible","voted","ta","nil","staon","absent","participation","partyCompared","withParty","withPartyRate"]}},"required":["representative","groupBy","eligibilityKnown","terms","parties","periods","totals"]},"FeedFreshness":{"type":"object","properties":{"id":{"type":"string","enum":["members","votes","questions","debates","legislation"]},"name":{"type":"string"},"covers":{"type":"string"},"status":{"type":"string","enum":["operational","degraded","down"]},"lastSuccessAt":{"type":"string","format":"date-time","nullable":true},"ageMinutes":{"type":"integer","nullable":true},"staleAfterMinutes":{"type":"integer"},"lastRunStatus":{"type":"string","enum":["succeeded","failed","running"],"nullable":true},"latestRecordDate":{"type":"string","format":"date","nullable":true}},"required":["id","name","covers","status","lastSuccessAt","ageMinutes","staleAfterMinutes","lastRunStatus","latestRecordDate"]},"UpstreamState":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string","enum":["operational","degraded","down"]},"since":{"type":"string","format":"date-time","nullable":true},"lastOkAt":{"type":"string","format":"date-time","nullable":true},"lastCheckedAt":{"type":"string","format":"date-time","description":"Null until the first check has run.","nullable":true},"latencyMs":{"type":"integer","nullable":true},"uptime30d":{"type":"number","nullable":true},"detail":{"type":"string","nullable":true}},"required":["id","name","status","since","lastOkAt","lastCheckedAt","latencyMs","uptime30d","detail"]},"FinanceDataset":{"type":"object","properties":{"key":{"type":"string"},"title":{"type":"string"},"publisher":{"type":"string"},"landingUrl":{"type":"string","format":"uri"},"licence":{"type":"string","nullable":true},"cadenceHours":{"type":"integer"},"expectedRelease":{"type":"string","nullable":true},"coverageNote":{"type":"string","nullable":true},"automation":{"type":"string","enum":["automatic","reviewed"]},"latestPublicationAt":{"type":"string","format":"date","nullable":true},"lastCheckedAt":{"type":"string","format":"date-time","nullable":true},"lastSuccessAt":{"type":"string","format":"date-time","nullable":true},"health":{"type":"string","enum":["current","stale","failing","never"]},"publishedObservations":{"type":"integer"}},"required":["key","title","publisher","landingUrl","licence","cadenceHours","expectedRelease","coverageNote","automation","latestPublicationAt","lastCheckedAt","lastSuccessAt","health","publishedObservations"]},"FinanceObservation":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"dataset":{"type":"string"},"metric":{"type":"string"},"entity":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"}},"required":["id","label"]},"basis":{"type":"string"},"frequency":{"type":"string"},"periodStart":{"type":"string","format":"date"},"periodEnd":{"type":"string","format":"date"},"cumulative":{"type":"boolean"},"grossNet":{"type":"string"},"accounting":{"type":"string"},"coverage":{"type":"string"},"originalAmount":{"type":"string"},"originalScale":{"type":"string"},"currency":{"type":"string"},"amountEur":{"type":"string","nullable":true},"dimensions":{"type":"object","properties":{},"required":[]},"source":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"title":{"type":"string"},"publisher":{"type":"string"},"reference":{"type":"string","nullable":true},"publishedAt":{"type":"string","format":"date","nullable":true},"retrievedAt":{"type":"string","format":"date-time"}},"required":["url","title","publisher","reference","publishedAt","retrievedAt"]},"revision":{"type":"integer"}},"required":["id","dataset","metric","entity","basis","frequency","periodStart","periodEnd","cumulative","grossNet","accounting","coverage","originalAmount","originalScale","currency","amountEur","dimensions","source","revision"]},"ApiUsage":{"type":"object","properties":{"period":{"type":"object","properties":{"start":{"type":"string","format":"date"},"days":{"type":"integer"}},"required":["start","days"]},"totals":{"type":"object","properties":{"requests":{"type":"integer"},"rateLimited":{"type":"integer"},"serverErrors":{"type":"integer"},"averageLatencyMs":{"type":"integer"},"maxLatencyMs":{"type":"integer"}},"required":["requests","rateLimited","serverErrors","averageLatencyMs","maxLatencyMs"]},"days":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"requests":{"type":"integer"},"rateLimited":{"type":"integer"},"serverErrors":{"type":"integer"},"averageLatencyMs":{"type":"integer"},"maxLatencyMs":{"type":"integer"}},"required":["date","requests","rateLimited","serverErrors","averageLatencyMs","maxLatencyMs"]}},"routes":{"type":"array","items":{"type":"object","properties":{"route":{"type":"string"},"method":{"type":"string"},"requests":{"type":"integer"},"rateLimited":{"type":"integer"},"serverErrors":{"type":"integer"},"averageLatencyMs":{"type":"integer"},"maxLatencyMs":{"type":"integer"}},"required":["route","method","requests","rateLimited","serverErrors","averageLatencyMs","maxLatencyMs"]}}},"required":["period","totals","days","routes"]},"Status":{"type":"object","properties":{"status":{"type":"string","enum":["operational","degraded","down"]},"checkedAt":{"type":"string","format":"date-time"},"api":{"type":"object","properties":{"status":{"type":"string","enum":["operational","degraded","down"]}},"required":["status"]},"feeds":{"type":"array","items":{"$ref":"#/components/schemas/FeedFreshness"}},"upstream":{"type":"array","items":{"$ref":"#/components/schemas/UpstreamState"}},"financeDatasets":{"type":"array","items":{"$ref":"#/components/schemas/FinanceDataset"}},"notes":{"type":"array","items":{"type":"string"}}},"required":["status","checkedAt","api","feeds","upstream","financeDatasets","notes"]},"Party":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"members":{"type":"integer"}},"required":["id","name","members"]},"Constituency":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"county":{"type":"string","nullable":true},"seats":{"type":"integer","nullable":true},"members":{"type":"integer"}},"required":["id","name","county","seats","members"]},"Webhook":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"url":{"type":"string","format":"uri"},"events":{"type":"array","items":{"type":"string","enum":["division.created","division.corrected","question.created","question.revised","speech.created","speech.revised","bill.stage_changed"]}},"representative":{"type":"string","nullable":true},"status":{"type":"string","enum":["active","disabled"]},"createdAt":{"type":"string","format":"date-time"}},"required":["id","url","events","representative","status","createdAt"]},"WebhookCreated":{"allOf":[{"$ref":"#/components/schemas/Webhook"},{"type":"object","properties":{"secret":{"type":"string","description":"Shown once. Verify `X-DailDex-Signature` with HMAC-SHA256(secret, timestamp + `.` + raw body)."}},"required":["secret"]}]},"WebhookDelivery":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"event":{"type":"string"},"status":{"type":"string","enum":["pending","delivered","dead"]},"attempts":{"type":"integer"},"lastError":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time"},"deliveredAt":{"type":"string","format":"date-time","nullable":true},"nextAttemptAt":{"type":"string","format":"date-time","nullable":true}},"required":["id","event","status","attempts","lastError","createdAt","deliveredAt","nextAttemptAt"]},"CreateWebhook":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Public https URL."},"events":{"type":"array","items":{"type":"string","enum":["division.created","division.corrected","question.created","question.revised","speech.created","speech.revised","bill.stage_changed"]}},"representative":{"type":"string","description":"Only send events involving this representative id."}},"required":["url","events"]}},"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional API key: `dd_live_...`."}}}}