{"openapi":"3.1.0","info":{"title":"UK Parliament API","version":"1.0.0","description":"The UK Parliament as an API — Members of the House of Commons (MPs) and the House of Lords, and the bills passing through Parliament, live from the official UK Parliament data services. Search members by name and house and get their party, constituency or peerage, gender, portrait and membership dates; look up any member by id; and search the bills currently before (or recently passed) Parliament with their long and short titles, originating and current house, and current stage (e.g. Report stage, Royal Assent). Ideal for civic-tech, news, political-research, transparency and government-monitoring apps. Open data from the UK Parliament.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/ukparliament-api","description":"oanor gateway"}],"tags":[{"name":"UK Parliament"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/bills":{"get":{"operationId":"get_v1_bills","tags":["UK Parliament"],"summary":"Search bills before Parliament","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Search term (full-text)","schema":{"type":"string"}},{"name":"current_house","in":"query","required":false,"description":"commons | lords","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"date (default) | title","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Results per page (1-50, default 20)","schema":{"type":"string"},"example":"20"},{"name":"skip","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":20,"total":3891,"results":[{"id":4030,"url":"https://bills.parliament.uk/bills/4030","title":"Railways Bill","is_act":false,"is_defeated":false,"last_update":"2026-05-29T21:30:34.5777116","current_house":"Commons","current_stage":"Report stage","originating_house":"Commons"},{"id":4080,"url":"https://bills.parliament.uk/bills/4080","title":"Representation of the People Bill","is_act":false,"is_defeated":false,"last_update":"2026-05-29T21:16:22.5580253","current_house":"Commons","current_stage":"Report stage","originating_house":"Commons"},{"id":4123,"url":"https://bills.parliament.uk/bills/4123","title":"Steel Industry (Nationalisation) Bill","is_act":false,"is_defeated":false,"last_update":"2026-05-29T18:46:12.9017698","current_house":"Commons","current_stage":"Committee of the whole House","originating_house":"Commons"},{"id":4065,"url":"https://bills.parliament.uk/bills/4065","title":"Armed Forces Bill","is_act":false,"is_defeated":false,"last_update":"2026-05-29T17:20:19.0901143","current_house":"Commons","current_stage":"Programme motion","originating_house":"Commons"},{"id":4127,"url":"https://bills.parliament.uk/bills/4127","title":"Sporting Events Bill [HL]","is_act":false,"is_defeated":false,"last_update":"2026-05-29T15:30:30.1313804","current_house":"Lords","current_stage":"2nd reading","originating_house":"Lords"},{"id":4129,"url":"https://bills.parliament.uk/bills/4129","title":"Financial Services and Markets Bill [HL]","is_act":false,"is_defeated":false,"last_update":"2026-05-29T15:24:43.1692926","current_house":"Lords","current_stage":"2nd reading","originating_house":"Lords"},{"id":4128,"url":"https://bills.parliament.uk/bills/4128","title":"Commercial Payments Bill [HL]","is_act":false,"is_defeated":false,"last_update":"2026-05-29T15:13:46.0949882","current_house":"Lords","current_stage":"2nd reading","originating_house":"Lords"},{"id":4126,"url":"https://bills.parliament.uk/bills/4126","title":"Social Housing Bill [HL]","is_act":false,"is_defeated":false,"last_update":"2026-05-29T14:31:46.2358789","current_house":"Lords","current_stage":"2nd reading","originating_house":"Lords"},{"id":4125,"url":"https://bills.parliament.uk/bills/4125","title":"Civil Aviation (Consumer Protection and Regulatory Reform) Bill [HL]","is_act":false,"is_defeated":false,"last_update":"2026-05-29T14:14:39.2070337","current_house":"Lords","current_stage":"2nd reading","originating_house":"Lords"},{"id":4019,"url":"https://bills.parliament.uk/bills/4019","title":"Public Office (Accountability) Bill","is_act":false,"is_defeated":false,"last_update":"2026-05-28T18:36:24.8931431","current_house":"Commons","current_stage":"Report stage","originating_house":"Commons"},{"id":4022,"url":"https://bills.parliament.uk/bills/4022","title":"Northern Ireland Troubles Bill","is_act":false,"is_defeated":false,"last_update":"2026-05-28T17:30:38.4606001","current_house":"Commons","current_stage":"Committee of the whole House","originating_house":"Commons"},{"id":4035,"url":"https://bills.parliament.uk/bills/4035","title":"Cyber Security and Resilience (Network and Information Systems) Bill","is_act":false,"is_defeated":false,"last_update":"2026-05-21T20:18:52.9906582","current_house":"Commons","current_stage":"Report stage","originating_house":"Commons"},{"id":4124,"url":"https://bills.parliament.uk/bills/4124","title":"Health Bill","is_act":false,"is_defeated":false,"last_update":"2026-05-21T11:20:22.9723215","current_house":"Commons","current_stage":"2nd reading","originating_house":"Commons"},{"id":4083,"url":"https://bills.parliament.uk/bills/4083","title":"Courts and Tribunals Bill","is_act":false,"is_defeated":false,"last_update":"2026-05-15T14:11:20.2727187","current_house":"Commons","current_stage":"Report stage","originating_house":"Commons"},{"id":3094,"url":"https://bills.parliament.uk/bills/3094","title":"High Speed Rail (Crewe - Manchester) Bill","is_act":false,"is_defeated":false,"last_update":"2026-05-15T13:44:02.1801868","current_house":"Commons","current_stage":"Bill reintroduced","originating_house":"Commons"},{"id":4002,"url":"https://bills.parliament.uk/bills/4002","title":"English Devolution and Community Empowerment Act 2026","is_act":true,"is_defeated":false,"last_update":"2026-05-14T10:26:18.9471729","current_house":"Unassigned","current_stage":"Royal Assent","originating_house":"Commons"},{"id":3774,"url":"https://bills.parliament.uk/bills/3774","title":"Terminally Ill Adults (End of Life) Bill","is_act":false,"is_defeated":false,"last_update":"2026-05-14T10:14:43.1519297","current_house":"Lords","current_stage":"Committee stage","originating_house":"Commons"},{"id":4046,"url":"https://bills.parliament.uk/bills/4046","title":"National Insurance Contributions (Employer Pensions Contributions) Act 2026","is_act":true,"is_defeated":false,"last_update":"2026-05-14T10:09:48.2352459","current_house":"Unassigned","current_stage":"Royal Assent","originating_house":"Commons"},{"id":3923,"url":"https://bills.parliament.uk/bills/3923","title":"Marine Protected Areas (Bottom Trawling) (England) Bill","is_act":false,"is_defeated":false,"last_update":"2026-05-13T15:28:15.7077842","current_house":"Commons","current_stage":"1st reading","originating_house":"Commons"},{"id":3896,"url":"https://bills.parliament.uk/bills/3896","title":"City of London (Markets) Bill","is_act":false,"is_defeated":false,"last_update":"2026-05-13T12:42:53.8235746","current_house":"Commons","current_stage":"Committee stage","originating_house":"Commons"}]},"meta":{"timestamp":"2026-05-31T10:30:27.395Z","request_id":"56c33a87-4f67-43f3-bcb6-18b930705559"},"status":"ok","message":"Bills searched","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/member":{"get":{"operationId":"get_v1_member","tags":["UK Parliament"],"summary":"One member by id","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Member id, e.g. 172 (Diane Abbott)","schema":{"type":"string"},"example":"172"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"member":{"id":172,"name":"Ms Diane Abbott","house":"Commons","party":"Independent","gender":"F","thumbnail":"https://members-api.parliament.uk/api/Members/172/Thumbnail","full_title":"Rt Hon Diane Abbott MP","is_current":true,"member_since":"1987-06-11T00:00:00","membership_from":"Hackney North and Stoke Newington"}},"meta":{"timestamp":"2026-05-31T10:30:27.555Z","request_id":"3b3e3799-0e07-4cdf-8ea7-37bdb3d6a918"},"status":"ok","message":"Member retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/members":{"get":{"operationId":"get_v1_members","tags":["UK Parliament"],"summary":"Search MPs & Lords","description":"","parameters":[{"name":"name","in":"query","required":true,"description":"Member name, e.g. Sunak","schema":{"type":"string"},"example":"Sunak"},{"name":"house","in":"query","required":false,"description":"commons | lords","schema":{"type":"string"}},{"name":"current","in":"query","required":false,"description":"false = include former members","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Results per page (1-50, default 20)","schema":{"type":"string"},"example":"20"},{"name":"skip","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":1,"query":"Sunak","total":1,"results":[{"id":4483,"name":"Rishi Sunak","house":"Commons","party":"Conservative","gender":"M","thumbnail":"https://members-api.parliament.uk/api/Members/4483/Thumbnail","full_title":"Rt Hon Rishi Sunak MP","is_current":true,"member_since":"2015-05-07T00:00:00","membership_from":"Richmond and Northallerton"}]},"meta":{"timestamp":"2026-05-31T10:30:27.940Z","request_id":"034a023f-9755-4d17-b7ab-8c5c7d2dbf10"},"status":"ok","message":"Members searched","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Source & options","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Live UK Parliament data. /v1/members searches Members of the House of Commons (MPs) and House of Lords by name and house; /v1/member returns one member by id; /v1/bills searches bills currently before (or recently passed) Parliament with their current stage.","houses":["commons","lords"],"source":"UK Parliament (members-api & bills-api.parliament.uk)","endpoints":["/v1/members","/v1/member","/v1/bills","/v1/meta"]},"meta":{"timestamp":"2026-05-31T10:30:27.991Z","request_id":"c2738c88-b5a7-4eb5-b726-8944c3b34a20"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":3950,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":485,"monthly_call_quota":52500,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1330,"monthly_call_quota":251000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3540,"monthly_call_quota":1208000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/ukparliament-api"}