https://api.daildex.comcurl -s "https://api.daildex.com/v1/representatives?q=whitmore"
curl -s "https://api.daildex.com/v1/votes?representative=jennifer-whitmore&date_start=2026-09-01&limit=1"DáilDex API · beta
Votes, parliamentary questions, debates and bills from the Houses of the Oireachtas, plus published observations from public-finance datasets. Parliamentary records link back to the official source; each finance dataset lists its publisher, update status and licence. Free to use without signing up, with a free API key for higher limits and a public MCP server for AI assistants. It is a beta run by a small team on a best-effort basis.
No signup is needed to try it. Anonymous use is limited to 600 requests an hour per IP address.
Open source backend under the MIT licence, with local setup instructions. Browse the code · Read the announcement
Parliamentary records, committees and curated public-finance datasets. Votes since 10 March 2016; questions and speeches since July 2026. Parliamentary records link to the official Oireachtas source.
Dáil divisions since 10 March 2016: the tallies, the party breakdown and how each member voted. The voting-record route shows how one member has voted over time.
Written and oral questions since July 2026, with the question, the written answer and who asked it. List routes cut the text at 500 characters; the detail route returns all of it.
Speeches by member, debate and date, since July 2026.
Bill status and every stage with its House, date and outcome, the published amendment lists, the stage changes we have seen, related debates and documents. Refreshed every six hours.
Browse the dataset catalogue and published observations with source, reporting basis, period, units and provenance. Dataset responses show their own update health and source-specific licence; observations still in review are not public.
TDs with party, constituency, dated terms and party history, and a summary of their record. Refreshed daily.
Dáil, Seanad and joint committees with their members and offices such as chair and vice-chair, and the hearings DáilDex holds contributions for. Refreshed daily.
Votes, questions and debates are fetched from the Oireachtas every hour. Data responses carry X-Data-As-Of and include meta.data_as_of where the response has a metadata envelope. The public status page shows each parliamentary feed, finance dataset and whether the official API has changed.
So you can plan around it instead of finding out later.
Committee membership, offices and the hearings we hold contributions for are included, and contributions at committee hearings are included as speeches under each committee's name. Committee votes and reports are not included yet.
Dáil votes go back to 10 March 2016 (the 32nd Dáil). They are complete from 20 February 2020; before that, the 32nd Dáil is held only up to 15 February 2018. Questions and speeches start in July 2026.
One server, no uptime guarantee and no service-level agreement. Expect new fields; we will try to avoid changes that break existing clients.
No key needed. These calls return data today: find a TD, then list their recent votes.
https://api.daildex.comcurl -s "https://api.daildex.com/v1/representatives?q=whitmore"
curl -s "https://api.daildex.com/v1/votes?representative=jennifer-whitmore&date_start=2026-09-01&limit=1"application/json{
"votes": [
{
"id": "f76bcbaa-9a6f-49aa-8d92-cbd54b610d4f:jennifer-whitmore",
"divisionId": "f76bcbaa-9a6f-49aa-8d92-cbd54b610d4f",
"type": "vote",
"date": "2026-09-30",
"title": "Question put: \"That the Bill be now read a Second Time\"",
"summary": "Lost · Electricity Regulation (Climate Action and Connection to Distribution and Transmission Systems) Bill 2025: Second Stage (Resumed) [Private Members]",
"sourceUrl": "https://www.oireachtas.ie/en/debates/vote/dail/34/2026-09-30/206/",
"representative": {
"id": "jennifer-whitmore",
"name": "Jennifer Whitmore",
"area": "Wicklow",
"party": "Social Democrats",
"role": "TD",
"chamber": "Dáil"
},
"participation": "Tá"
}
],
"limit": 1,
"offset": 0,
"next_cursor": "opaque-cursor-string",
"has_more": true,
"meta": {
"count": 1,
"limit": 1,
"next_cursor": "opaque-cursor-string",
"has_more": true,
"licence": {
"name": "Oireachtas (Open Data) PSI Licence",
"url": "https://www.oireachtas.ie/en/open-data/",
"attribution": "Contains Parliamentary information licensed under the Oireachtas (Open Data) PSI Licence"
},
"fetched_at": "2026-10-02T09:00:00Z"
}
}fetchconst response = await fetch(
"https://api.daildex.com/v1/questions?limit=1"
);
const { questions } = await response.json();
// summary is cut at 500 characters. Fetch the detail route for the full
// question and the written answer:
const detail = await fetch(`https://api.daildex.com/v1/questions/${questions[0].id}`);
const { data } = await detail.json();
console.log(data.question, data.answer);The response is abridged. List routes cut question and speech text at 500 characters in the summary field; use the detail route for the full text.
Every route is a GET and returns JSON. Paths are relative to the base URL.
This is a summary. The OpenAPI spec is the authoritative, machine-readable reference, and the interactive docs let you try calls in the browser. OpenAPI spec (openapi.json) · Interactive docs
Beta
/v1/representativesList TDs. Returns id, name, area, party, role and chamber.
Parameters: q, chamber, party, constituency, status
/v1/representatives/:idOne member with status, source link and a record summary (divisions, votes by type, questions, since). Add /votes, /questions, /speeches or /committees to list only that member's records.
Also: /v1/representatives/:id/votes /v1/representatives/:id/questions /v1/representatives/:id/speeches /v1/representatives/:id/committees
/v1/representatives/:id/voting-recordHow one member has voted over time, grouped by year, month or Dáil: votes cast, Tá/Níl/Staon, absences while they held a seat, and how often they voted with their party's majority.
Parameters: group_by, date_start, date_end
/v1/committeesDáil, Seanad and joint committees with their current member counts. Defaults to the sitting Dáil and Seanad; use status=all for earlier ones.
Parameters: q, house, house_no, type, status, representative
/v1/committees/:idOne committee with its members and offices (chair, vice-chair) and the recent hearings DáilDex holds contributions for. IDs look like dail-34-committee_of_public_accounts.
/v1/divisionsOne row per division with date, title, outcome and Tá/Níl/Staon tallies. Filter by text, dates, outcome or member.
Parameters: q, chamber, date_start, date_end, outcome, representative, limit, cursor
/v1/divisions/:idA single division with its party breakdown. Add ?include=members to get every member's vote. IDs are UUIDs.
Parameters: include=members
/v1/votesPer-member vote rows (one per TD per division) with participation: Tá, Níl or Staon. Older shape, kept for compatibility.
Parameters: representative, chamber, date_start, date_end, q, limit, offset, cursor
/v1/questionsParliamentary questions with the member who asked. Text is cut at 500 characters in the summary field.
Parameters: representative, chamber, date_start, date_end, q, limit, offset, cursor
/v1/questions/:idOne question with its full text, the written answer, the department and the question number.
/v1/speechesDebate contributions by member. Text is cut at 500 characters in the summary field.
Parameters: representative, chamber, date_start, date_end, q, limit, offset, cursor
/v1/speeches/:idOne contribution with its full text, debate and section.
/v1/billsSearch bills by text, year, status, current stage or date. IDs look like 2026/42.
Parameters: q, year, status, stage, date_start, date_end, limit, cursor
/v1/bills/movementsBills we saw move to a new stage, newest first, with the stage they came from.
Parameters: date_start, date_end, limit, cursor
/v1/bills/:year/:numberA bill with every stage (House, date, outcome), its published amendment lists, the stage changes we have seen, related debates and documents.
/v1/legislationOlder legislation list with status and current stage. Prefer /v1/bills for new work.
Parameters: q, date_start, date_end, limit, offset, cursor
/v1/activityOne timeline across votes, questions, speeches and legislation. Choose with type.
Parameters: type, representative, chamber, date_start, date_end, q, limit, offset, cursor
/v1/partiesParties with their current member counts.
/v1/constituenciesConstituencies with county, seats and members.
/v1/datasetsList curated public-finance datasets with publisher, licence, coverage, update cadence and current health.
/v1/datasets/:keyGet source, licence, coverage and update details for one dataset key.
/v1/datasets/:key/observationsList published observations for a dataset. Filter by metric, entity, basis and period; pages include source provenance and dataset licence. Pending review records are excluded.
Parameters: metric, entity, basis, date_start, date_end, limit, offset, cursor
/v1/usageGet daily request counts, response errors and latency by route for this API key over the last 30 days. Requires that key; reports are aggregated and retained for 90 days.
API key required: Authorization: Bearer API_KEY
/v1/dex/balanceGet the available Dex API balance and daily spending limit for this enabled key.
API key required: Authorization: Bearer API_KEY
/v1/statusHow recently each feed was synced, and whether the official Oireachtas API is reachable and unchanged. The same information is on the public status page.
The rules that apply to every route.
Everything lives under https://api.daildex.com/v1 and is JSON over HTTPS. CORS is open for GET, so you can call it from a browser.
Anonymous requests work. Send a free API key as a Bearer token for a higher limit. Create one on the keys page; it needs a DáilDex account.
Anonymous: 600 requests an hour per IP address. With a free API key: 5,000 requests a day. Every response carries RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset, and a 429 also carries Retry-After.
Pass limit, then follow meta.next_cursor as the cursor parameter until has_more is false. The older offset parameter still works in this version but is on its way out.
New routes return an object with data and meta. meta holds count, limit, next_cursor, has_more, the licence, fetched_at and data_as_of (when the data behind the response was last synced from the Oireachtas). Older list routes keep their original top-level arrays and add the same meta.
Errors on /v1 return an error object with a code, a message and a list of fields. Unknown query parameters and bad values return 400 INVALID_REQUEST with the offending field listed, rather than being ignored silently.
Responses send Cache-Control: public, max-age=60, s-maxage=300, so repeated identical calls may be served from a cache for a few minutes.
Authorizationcurl -s "https://api.daildex.com/v1/divisions?date_start=2026-09-01&limit=5" \
-H "Authorization: Bearer dd_live_YOUR_KEY"cursorcurl -s "https://api.daildex.com/v1/divisions?limit=5&cursor=opaque-cursor-string"400{
"error": {
"code": "INVALID_REQUEST",
"message": "Invalid request: date_start — Invalid ISO date",
"fields": [
{ "field": "date_start", "issue": "Invalid ISO date" }
]
}
}A public, read-only MCP server (Streamable HTTP) exposes the same data as tools, so an AI assistant can look up votes and questions and cite the official source instead of guessing.
Add a custom connector and use this URL. No authentication is needed.
Streamable HTTPhttps://api.daildex.com/mcpJSON{
"mcpServers": {
"daildex": {
"command": "npx",
"args": ["mcp-remote", "https://api.daildex.com/mcp"]
}
}
}Add this to your MCP config (claude_desktop_config.json, or Cursor's mcp.json). It uses mcp-remote to connect to the HTTP server and needs Node.js.
find_representativeFind a TD by name, constituency or party.
get_representativeGet a member's profile and a summary of their voting and question record.
search_divisionsSearch Dáil divisions (votes) by keyword, date or outcome.
get_divisionGet one division with its tallies, party breakdown and, if you ask, how each member voted.
how_did_they_voteLook up how a named member voted on a topic or division.
search_questionsSearch parliamentary questions and their answers.
search_debatesSearch debate speeches.
get_billGet a bill's status, stages, amendment lists and related debates.
get_activityBrowse recent activity across votes, questions, speeches and legislation.
list_committeesFind committees by name, type, house or a member's seat.
get_committeeGet a committee with its members, offices and recent hearings.
get_voting_recordSee how a member has voted over time, by year, month or Dáil, including how often they voted with their party.
recent_bill_movementsList bills that recently moved to a new stage.
get_statusCheck how recently each data feed was refreshed and whether the official source is reachable.
The MCP server counts requests separately from the REST API: 1,800 an hour per IP address without a key (a single tool call can take a few requests), and the same daily allowance as the REST API with a key. It is a best-effort beta.
Get a signed POST when divisions, questions, speeches or bill stages are added or corrected. Webhooks need an API key.
Subscribe to division.created, division.corrected, question.created, question.revised, speech.created, speech.revised or bill.stage_changed and, optionally, filter by one representative. Deliveries are signed: X-DailDex-Signature is sha256= followed by the HMAC-SHA256 of the timestamp and raw body, using the secret returned when you create the webhook. Verify it before you trust the content. You can list (GET /v1/webhooks) and delete (DELETE /v1/webhooks/:id) your webhooks.
POST /v1/webhookscurl -s -X POST "https://api.daildex.com/v1/webhooks" \
-H "Authorization: Bearer dd_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com/hooks/daildex",
"events": ["division.corrected", "question.revised", "bill.stage_changed"]
}'X-DailDex-Signatureimport { createHmac, timingSafeEqual } from "node:crypto";
// Pass the exact request body bytes, x-daildex-timestamp and x-daildex-signature.
// secret: returned when you created the webhook.
function isValid(rawBody, timestamp, signature, secret) {
if (typeof signature !== "string" || !/^sha256=[0-9a-f]{64}$/.test(signature)) return false;
if (!/^\d{10}$/.test(timestamp) || Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) return false;
const signedBody = Buffer.concat([Buffer.from(timestamp + "."), rawBody]);
const expected = "sha256=" + createHmac("sha256", secret).update(signedBody).digest("hex");
return signature.length === expected.length &&
timingSafeEqual(Buffer.from(signature), Buffer.from(expected));
}The nightly export now covers members and terms, parties, votes, questions, speeches, bills and stages, committees and memberships, plus published finance observations. It produces CSV and gzipped NDJSON snapshots with a manifest and checksums. Public hosting is being prepared.
Public downloads are not live yet.
Parliamentary records come from the Houses of the Oireachtas Open Data API and are published under the Oireachtas (Open Data) PSI Licence. Finance datasets retain their own source licences, shown with each dataset at /v1/datasets. Follow the listed licence and attribution for the data you reuse. For parliamentary records, include this notice:
Oireachtas attribution: Contains Parliamentary information licensed under the Oireachtas (Open Data) PSI Licence
DáilDex is independent and is not an official Oireachtas service. Our cleaning, matching and summaries are not official; finance dataset sources and licences are listed separately. Check the linked source for anything important. Read the licence
Tell us what you are making, or what is missing. Bug reports and questions about the data are welcome at support@daildex.com.