UK Petitions

UK Parliament Petitions

Official UK Parliament petitions API. No authentication required.

Data Model

• Petition — A public petition with an action (title), background, signature count, and lifecycle state.
• State — open (collecting signatures), closed (deadline passed), rejected, debated, responded (government replied), awaiting_response, awaiting_debate.
• Government Response — Official response added when a petition reaches 10,000 signatures.
• Debate — Parliamentary debate scheduled when a petition reaches 100,000 signatures.

Key Fields

• id — Unique petition identifier (integer)
• attributes.action — Short title / what the petition asks for
• attributes.signature_count — Current number of signatures
• attributes.state — Lifecycle state
• attributes.government_response — Object with summary and details (null if < 10k signatures)
• attributes.debate — Object with debated_on, transcript_url, video_url (null if < 100k)

Gotchas

• JSON suffix: All endpoints require .json suffix for JSON responses.
• Pagination: List endpoints use page query parameter. Links object contains first, last, next, prev.
• States for filtering: open, closed, rejected, debated, awaiting_response, awaiting_debate, all.
• Signature thresholds: 10,000 = government must respond, 100,000 = considered for debate.