{"id":"7e8135fc-942e-4ed1-bebd-86e594c6e4d1","type":"API","name":"Houses of the Oireachtas Open Data APIs","slug":"houses-of-the-oireachtas-open-data-apis","description":"The Houses of the Oireachtas are providing these APIs to allow our datasets to be retrieved and reused as widely as possible. They are intended to be used in conjunction with https://data.oireachtas.ie, from where our datasets can be accessed directly. By using the APIs, users can make metadata queries to identify the specific data they require. New data are available through the API as soon as they are published. Currently, https://data.oireachtas.ie contains data in XML format from the Official Report of the Houses of the Oireachtas (the “debates”) and replies to Parliamentary Questions in XML files complying with the Akoma Ntoso schema, as well data in PDF format for Bills, Acts and other documents published by the Houses of the Oireachtas. Files can be retrieved from https://data.oireachtas.ie by adding the URI fragment contained in the “formats” fields of the JSON documents returned by these APIs. At the moment only PDF and XML files are available directly from https://data.oireachtas.ie, but this will become the endpoint for direct access of all “uri” fields in the data queried through https://api.oireachtas.ie. We will also be making bulk downloads available through https://data.oireachtas.ie. Please note the APIs are a work in progress. We are working on expanding the range of datasets we publish, and we are interested in hearing about how to make these APIs more useful and wide ranging. For these reasons, we welcome any feedback, suggestions and user stories to open.data@oireachtas.ie Data published through these APIs are made available under the Oireachtas (Open Data) PSI Licence.","free_access_class":"FREE_NO_AUTH","auth_type":"NONE","homepage_url":null,"docs_url":null,"repo_url":"https://api.oireachtas.ie/v1/debates","status":"ACTIVE","verification_state":"UNVERIFIED","tags":["government","legislation"],"logo_url":"https://www.google.com/s2/favicons?sz=64&domain=api.oireachtas.ie","primary_source_url":"https://api.oireachtas.ie/v1/debates","extraction_confidence":"0.28","created_at":"2026-06-24T18:59:51.337Z","updated_at":"2026-10-12T20:48:49.057Z","last_verified_at":"2026-09-07T14:42:48.371Z","deprecated_at":null,"ranking_score":40,"last_ranked_at":"2026-10-11T08:10:12.812Z","last_seen_at":null,"last_validated_at":null,"last_uptime_at":"2026-10-07T16:42:43.102Z","search_vector":"'a':557B,617B,694B 'about':578B 'access':46B,174B,290B,531B,647B 'accessed':403B 'act':118B,312B 'acts':475B,669B 'ad':136B 'adding':493B 'akoma':107B,303B,464B,660B 'all':533B 'allow':18B,375B 'alongsid':285B 'alongside':642B 'also':187B,544B 'and':381B,453B,476B,515B,572B,586B,597B,636B,654B,670B 'any':594B 'api':7A,16B,51B,70B,152B,198B,226B,249B,265B,288B,325B,333B,427B,682B 'api.oireachtas.ie':184B,541B 'apis':364A,373B,408B,509B,555B,583B,606B,622B,645B,690B 'are':370B,388B,423B,432B,518B,556B,562B,574B,607B,687B,691B,704B 'as':383B,385B,428B,430B,467B,665B,667B,683B,685B,693B 'at':510B 'avail':67B,162B,192B,252B,322B 'available':424B,519B,549B,609B,679B 'be':379B,391B,402B,488B,545B 'becom':169B,321B 'become':526B,678B 'bill':117B,311B 'bills':474B,668B 'bulk':190B,547B 'but':523B 'by':405B,480B,492B,507B,624B 'can':401B,410B,487B 'compli':104B 'compliant':306B,663B 'complying':461B 'conjunct':37B 'conjunction':394B 'contain':79B,140B 'contained':497B 'contains':436B 'coverag':342B 'coverage':699B 'current':77B 'currently':434B 'data':6A,61B,65B,80B,112B,181B,245B,257B,264B,320B,346B,353B,363A,418B,422B,437B,469B,538B,602B,614B,621B,677B,703B,710B 'data.oireachtas.ie':39B,78B,134B,165B,194B,286B,396B,435B,491B,522B,551B,643B 'dataset':20B,43B,212B,283B 'datasets':377B,400B,569B,640B 'debat':95B,292B 'debates':452B,649B 'describ':335B 'described':692B 'direct':47B,163B,173B,530B 'directly':404B,520B 'document':121B,148B,315B 'documents':478B,505B,672B 'download':191B 'downloads':548B 'enabl':276B 'enabling':633B 'endpoint':171B,528B 'expand':208B,343B 'expanding':565B,700B 'feedback':238B,595B 'field':144B,178B 'fields':501B,535B 'file':103B,129B,160B 'files':460B,486B,517B 'for':473B,529B,589B 'format':83B,115B,143B,318B,440B,472B,675B 'formats':500B 'fragment':139B,496B 'from':397B,441B,490B,521B,650B 'govern':356C 'hear':220B 'hearing':577B 'hous':1A,9B,90B,125B,269B 'houses':358A,366B,447B,482B,626B 'how':579B 'identifi':58B 'identify':415B 'in':393B,438B,458B,470B,498B,536B,559B,576B,659B,673B,696B 'intend':32B 'intended':389B 'interest':218B 'interested':575B 'irish':274B,631B 'json':147B,504B 'legisl':357C 'licenc':259B,355B 'licence':616B,712B 'made':251B,608B 'make':54B,189B,224B,411B,581B 'making':546B 'metadata':55B,277B,412B,634B 'moment':155B,512B 'more':584B 'new':64B,319B,421B,676B 'note':196B,553B 'ntoso':108B,305B,465B,662B 'ntoso-compli':304B 'ntoso-compliant':661B 'of':359A,367B,445B,448B,483B,502B,532B,568B,619B,627B,638B 'offici':86B,295B 'official':443B,652B 'oireachta':4A,12B,93B,128B,255B,272B,351B 'oireachtas':361A,369B,450B,485B,612B,629B,708B 'on':564B 'only':513B 'open':5A,256B,263B,352B,362A,613B,620B,709B 'open.data@oireachtas.ie':244B,601B 'other':477B,671B 'our':376B,399B 'over':701B 'parliament':275B,632B 'parliamentari':99B,282B,300B 'parliamentary':456B,639B,657B 'pdf':114B,157B,317B,471B,514B,674B 'pleas':195B 'please':552B 'possibl':29B 'possible':386B 'progress':203B,340B,560B,697B 'provid':14B,289B 'provide':646B 'providing':371B 'psi':258B,354B,615B,711B 'publish':76B,122B,214B,246B,266B,331B,571B 'published':433B,479B,603B,623B,688B 'queri':56B,182B,278B 'queried':539B 'queries':413B,635B 'question':100B,301B 'questions':457B,658B 'rang':210B,231B 'range':567B 'ranging':588B 'reason':234B 'reasons':591B 'releas':348B 'released':705B 'repli':97B,298B 'replies':454B,655B 'report':87B,296B,444B,653B 'requir':63B 'require':420B 'retriev':23B,132B,280B 'retrieval':637B 'retrieved':380B,489B 'return':149B 'returned':506B 'reus':25B 'reused':382B 'schema':109B,466B 'set':261B,618B 'soon':72B,327B,429B,684B 'specif':60B 'specific':417B 'stori':242B 'stories':599B 'suggest':239B 'suggestions':596B 'the':360A,365B,368B,407B,416B,426B,442B,446B,449B,451B,463B,481B,484B,494B,499B,503B,511B,527B,537B,554B,566B,611B,625B,628B,630B,644B,651B,681B,689B,707B 'these':372B,508B,582B,590B,605B 'they':387B,419B,431B,686B 'this':524B 'through':425B,540B,550B,604B,680B 'time':345B,702B 'to':374B,378B,390B,414B,455B,580B,600B,648B,656B 'under':610B,706B 'uri':138B,177B,495B,534B 'use':35B,49B,228B,284B 'used':392B,641B 'useful':585B 'user':52B,241B,598B 'users':409B 'using':406B 'we':542B,561B,570B,573B,592B 'welcom':236B 'welcome':593B 'well':111B,309B,468B,666B 'where':398B 'wide':27B,230B,587B 'widely':384B 'will':525B,543B 'with':395B,462B,698B 'work':201B,206B,338B,558B,695B 'working':563B 'xml':82B,102B,159B,307B,439B,459B,516B,664B","popularity_score":"0.0000","maintenance_score":"0.5000","institution_id":null,"institution_type":null,"country_code":"IE","official_confidence":null,"proof_summary":null,"source_seed_url":null,"is_public_sector":true,"published_at":"2026-06-24T18:59:51.337Z","geographic_scope":"NATIONAL","name_en":null,"description_en":"A set of open data APIs published by the Houses of the Oireachtas (the Irish parliament) enabling metadata queries and retrieval of parliamentary datasets. Used alongside data.oireachtas.ie, the APIs provide access to debates from the Official Report and replies to Parliamentary Questions in Akoma Ntoso-compliant XML, as well as Bills, Acts and other documents in PDF format. New data become available through the API as soon as they are published. The APIs are described as a work in progress, with coverage expanding over time. Data are released under the Oireachtas (Open Data) PSI Licence.","native_lang":"en","access_level":"documented","formats":[],"capability_tier":"reference","trust_score":20.5,"merged_into_entry_id":null,"identity_key":"API|https://api.oireachtas.ie/v1/debates|houses of the oireachtas open data apis","upstream_ref":null,"content_changed_at":"2026-10-09T19:37:28.661Z","title_qualifier":null,"access":{"level":"documented","primary":{"kind":"query","label":"Run verified request","method":"GET","url":"https://api.oireachtas.ie","source":"probe","runnable":true},"actions":[{"kind":"query","label":"Run verified request","method":"GET","url":"https://api.oireachtas.ie","source":"probe","runnable":true},{"kind":"landing","label":"Open source record","method":"GET","url":"https://api.oireachtas.ie/v1/debates","source":"primary_source","runnable":false}],"formats":[]},"maturity":{"entry_id":"7e8135fc-942e-4ed1-bebd-86e594c6e4d1","granularity":"entry","granularity_label":"One unit = one catalog entry. A PROXY for the SCOPE.md §4 ladder, which governs source families, not entries: a family with 400 entries moves this reading 400 times as much as a family with one. Never compare or combine with the source_family reading.","level":"discovered","level_index":1,"level_label":"Discovered","meaning":"Source and metadata recorded","counts_as_coverage":false,"blocked_by":null,"rungs":[{"level":"discovered","level_index":1,"label":"Discovered","meaning":"Source and metadata recorded","evidence":"membership of the named population the ladder is taken over","counts_as_coverage":false,"met":true,"reached":true,"criterion":"TRUE"},{"level":"verified","level_index":2,"label":"Verified","meaning":"Access tested successfully","evidence":"entries.verification_state = 'VERIFIED'","counts_as_coverage":false,"met":false,"reached":false,"criterion":"entries.verification_state = 'VERIFIED'"},{"level":"profiled","level_index":3,"label":"Profiled","meaning":"Schema, dimensions and licence understood","evidence":"a data profile with at least one field (entry_data_profiles.field_count > 0)","counts_as_coverage":false,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM entry_data_profiles p WHERE p.entry_id = entries.id AND COALESCE(p.field_count, 0) > 0)"},{"level":"executable","level_index":4,"label":"Executable","meaning":"Queries run through Commodity","evidence":"entries.capability_tier = 'live' — today's proxy for \"queryable through us\"","counts_as_coverage":true,"met":false,"reached":false,"criterion":"entries.capability_tier = 'live'"},{"level":"joinable","level_index":5,"label":"Joinable","meaning":"Canonical identifiers and concepts mapped","evidence":"a field link to a canonical identifier whose sampled VALUES match its format","counts_as_coverage":true,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM entry_field_links efl WHERE efl.entry_id = entries.id AND efl.identifier_id IS NOT NULL AND efl.value_status = 'match')"},{"level":"reproducible","level_index":6,"label":"Reproducible","meaning":"Snapshots and transformation evidence retained","evidence":"at least one retained evidence manifest (migration 078)","counts_as_coverage":true,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM evidence_manifests em WHERE em.entry_id = entries.id)"},{"level":"guaranteed","level_index":7,"label":"Guaranteed","meaning":"Monitored against an operational reliability target","evidence":"an active reliability target with a named monitor (migration 096)","counts_as_coverage":true,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM entry_reliability_targets rt WHERE rt.entry_id = entries.id AND rt.is_active = true)"}],"officialness":{"basis":"catalog_inherited","label":"Inherited from the upstream catalog: this item came from a trusted official government catalog, and that provenance — not per-item proof — is the warrant. Its own proof score is below 80 or it matched no registered institution (apps/worker/src/connectors/catalog/qualify-store.ts).","proof_confidence":null,"proven_threshold":80,"institution_id":null,"definition":"CASE WHEN COALESCE(entries.is_public_sector, false) IS NOT TRUE THEN 'not_official' WHEN COALESCE(entries.official_confidence, 0) >= 80 AND entries.institution_id IS NOT NULL THEN 'per_item_proven' ELSE 'catalog_inherited' END"},"source_family":{"key":"api.oireachtas.ie","label":"One unit = one source family, approximated by the serving host of the entry's primary source URL (e.g. bdl.stat.gov.pl). A COMPUTED stand-in for the curated families of SCOPE.md §5, which no table holds yet. A family sits at the highest level any of its entries has reached, because a family is integrated to the depth of its deepest working integration. Never compare or combine with the entry reading."},"generated_at":"2026-10-12T23:36:27.709Z"},"api_details":{"id":"1e50bbd2-e558-480c-8878-90f4f54e8ac4","entry_id":"7e8135fc-942e-4ed1-bebd-86e594c6e4d1","base_url":"https://api.oireachtas.ie","openapi_url":null,"graphql_url":null,"api_version":null,"spec_format":"rest","endpoints_count":null,"endpoints":[],"rate_limit_info":null,"free_tier_limits":null,"ping_url":null,"created_at":"2026-06-24T18:59:51.509Z","updated_at":"2026-06-24T18:59:51.509Z"},"dataset_details":null,"license":null,"reuse":{"license_id":null,"license_name":null,"license_url":null,"commercial_use":{"status":"unknown","value":null},"redistribution":{"status":"unknown","value":null},"attribution_required":{"status":"unknown","value":null},"share_alike":{"status":"unknown","value":null},"personal_data_warning":{"status":"unknown","value":null},"cache_and_mirror":{"status":"unknown","value":null},"undetermined":["commercial_use","redistribution","attribution_required","share_alike","personal_data_warning","cache_and_mirror"],"basis":"unverified","confidence":0.1,"confidence_tier":"low","source_text":null,"source_url":null,"reviewed_at":null},"license_raw":null,"latest_check":{"id":"c4471f0d-4fe3-4947-b378-0b7ad26e8ae4","entry_id":"7e8135fc-942e-4ed1-bebd-86e594c6e4d1","status":"UNVERIFIED","last_checked_at":"2026-10-12T19:22:42.614Z","p50_latency_ms":1546,"p95_latency_ms":null,"last_error":"Source URL is HTML, not a machine-readable API — possible mis-classification","consecutive_failures":0,"created_at":"2026-06-24T19:00:17.067Z","updated_at":"2026-10-12T19:22:42.614Z","consecutive_successes":238,"probe_url":"https://api.oireachtas.ie","probe_method":"GET","probe_http_status":200,"probe_content_type":"text/html; charset=utf-8","probe_succeeded_at":"2026-09-07T14:42:48.064Z"},"data_profile":{"id":"bc1805d7-a314-41be-9bba-33d0c3bc17ec","entry_id":"7e8135fc-942e-4ed1-bebd-86e594c6e4d1","profile_source":"none","profile_kind":"dataset","dataset_id":null,"fields":null,"field_count":null,"sample_records":null,"record_count":null,"data_size_bytes":null,"dataset_count":null,"query_examples":null,"status":"unsupported","error_message":"No introspectable source detected (primary URL sniffed: not machine-readable data)","profiled_at":"2026-10-09T19:37:27.654Z","run_id":"67d8ffc1-3930-4379-97fd-89d652b91da9","created_at":"2026-07-20T12:41:06.188Z","updated_at":"2026-10-09T19:37:27.654Z","license_raw":null,"license_id":null,"consecutive_failure_count":0,"last_error_at":null,"last_error_message":null,"previewable":false,"personal_data":{"status":"none","basis":"no_person_column_cited","grain":"none","allowed":true,"columns":{"direct_identifiers":[],"family_names":[],"given_names":[],"attributes":[],"unresolved_names":[],"measures":[],"entity_identifiers":[]},"publication":null,"publication_evidence":null,"notice":"personal data: no cited column names a natural person (the cited columns are all this reads)"}},"datasets":[],"limits":[],"manifest":{"answer_sha256":"4688c9b70e5a499b70b00d37296899e0b06e4661357ef24ef07a0b388a1e68b7","answer_sha256_rule":"sha256 (hex, UTF-8) of JSON.stringify(this body) after deleting the keys listed in manifest.stamped_keys from manifest, and deleting manifest itself if it is then empty. The hash was computed before the stamp existed, so no field of the stamp is inside it.","stamped_keys":["answer_sha256","answer_sha256_rule","stamped_keys","row_count","row_count_basis","live","live_basis","created_at","created_at_basis","durable_citation"],"row_count":9,"row_count_basis":"Objects that are elements of a JSON array anywhere in this body, excluding manifest. Not a claim about which collection is the answer. Largest single collection: maturity.rungs[] (7 rows).","live":true,"live_basis":"This body was produced by executing the request.","created_at":"2026-10-12T23:36:27.734Z","created_at_basis":"When this response body was assembled, deliberately OUTSIDE the hashed bytes so the same answer hashes identically on every request. Not the upstream read time — that is provenance[].retrieved_at. A zone-cached replay carries the assembly time, not your receipt time.","durable_citation":"This manifest is produced at response time and is NOT stored. A durable, replayable citation is persisted only on an explicit cite: GET /api/v1/entries/{id-or-slug}/evidence, or the MCP cite_query tool. Both are entry-scoped, because evidence_manifests is entry-shaped; a domain answer spanning several sources has no single entry and cannot be persisted through that path."}}