OpenParable
Skip to content
← Back to skills

Uk Legislation API

Apps & Automation
uk-legislation-api

Uk Legislation API is an Agent Skill for apps & automation published in the brycewang-stanford/Auto-Empirical-Research-Skills repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Access UK laws and statutory instruments via the Legislation.gov.uk API

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/blob/HEAD/skills/43-wentorai-research-plugins/skills/domains/law/uk-legislation-api/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/uk-legislation-api, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

UK Legislation API (legislation.gov.uk)

Overview

The Legislation.gov.uk API, maintained by The National Archives, provides open access to the full text of UK legislation from 1267 to the present day. The database covers over 100,000 items including Acts of Parliament, Statutory Instruments, Scottish and Welsh legislation, and Northern Ireland statutes. All data is available as structured XML with Dublin Core metadata, Atom feeds, and HTML. The API supports point-in-time versions showing how legislation read at any given date, plus amendment tracking.

Authentication

No authentication or API key is required. The API is fully open. Respect rate limits by adding reasonable delays between bulk requests.

URL Structure

All legislation follows the pattern:

https://www.legislation.gov.uk/{type}/{year}/{number}

Legislation Types

Type CodeDescriptionExample
ukpgaUK Public General Act/ukpga/2010/15 (Equality Act 2010)
uksiUK Statutory Instrument/uksi/2020/1374
aspAct of Scottish Parliament/asp/2020/13
ascAct of Senedd Cymru (Wales)/asc/2021/4
niaNorthern Ireland Act/nia/2022/2
uklaUK Local Act/ukla/2008/1
ukdsiUK Draft Statutory Instrument/ukdsi/2023/123
eurRetained EU Legislation/eur/2016/679 (GDPR)

Core Endpoints

Full Legislation Text (XML)

# Fetch the Equality Act 2010 — returns structured XML with Dublin Core metadata
curl "https://www.legislation.gov.uk/ukpga/2010/15/data.xml"
# Response: <Legislation DocumentURI="http://www.legislation.gov.uk/ukpga/2010/15"
#   NumberOfProvisions="564">
#   <dc:title>Equality Act 2010</dc:title>
#   <dc:description>An Act to make provision to require Ministers...</dc:description>

# Fetch Data Protection Act 2018
curl "https://www.legislation.gov.uk/ukpga/2018/12/data.xml"
# Response: <dc:title>Data Protection Act 2018</dc:title>
#   NumberOfProvisions="1181"

# Fetch a Statutory Instrument
curl "https://www.legislation.gov.uk/uksi/2020/1374/data.xml"
# Response: <dc:title>The Health Protection (Coronavirus, Restric...</dc:title>

Specific Sections

# Fetch a single section
curl "https://www.legislation.gov.uk/ukpga/2010/15/section/1/data.xml"

# Fetch table of contents
curl "https://www.legislation.gov.uk/ukpga/2010/15/contents/data.xml"

# Fetch a specific Part
curl "https://www.legislation.gov.uk/ukpga/2010/15/part/1/data.xml"

# Fetch a Schedule
curl "https://www.legislation.gov.uk/ukpga/2010/15/schedule/1/data.xml"

Search and Discovery

# Search by title — returns HTTP 300 with multiple matches
curl "https://www.legislation.gov.uk/id?title=equality+act"

# Browse by type, title keyword, and year
curl "https://www.legislation.gov.uk/ukpga?title=data+protection&year=2018"

# List recent Acts via Atom feed
curl "https://www.legislation.gov.uk/new/ukpga/data.feed"
# Response: <openSearch:totalResults> with <entry> elements per Act

Amendment Tracking

# Changes affecting a specific Act (Atom feed, paginated)
curl "https://www.legislation.gov.uk/changes/affected/ukpga/2010/15/data.feed"
# Response: <title>Changes to Legislation</title>
#   <leg:totalPages>25</leg:totalPages>
#   Each <entry> describes one amendment with source and target provisions

# Changes made BY a specific Act
curl "https://www.legislation.gov.uk/changes/affecting/ukpga/2010/15/data.feed"

Point-in-Time Versions

# Legislation as it stood on a specific date
curl "https://www.legislation.gov.uk/ukpga/2010/15/2015-01-01/data.xml"

# Enacted (original) version
curl "https://www.legislation.gov.uk/ukpga/2010/15/enacted/data.xml"

Data Formats

SuffixFormatContent-Type
/data.xmlLegislation XML (CLML)application/xml
/data.feedAtom feedapplication/atom+xml
/data.csvCSV exporttext/csv
(none)HTML renderingtext/html

The primary XML format uses the Crown Legislation Markup Language (CLML) schema with namespaces for legislation, ukm:Metadata, and Dublin Core (dc:, dct:) elements. Each document includes NumberOfProvisions, RestrictExtent (geographic applicability like E+W+S+N.I.), and RestrictStartDate.

Academic Use Cases

  • Legislative history: Track how a statute has evolved using point-in-time versions and amendment feeds
  • Policy analysis: Compare regulatory regimes across UK jurisdictions (England, Scotland, Wales, NI)
  • Corpus linguistics: Build legislative text corpora from XML for NLP analysis of legal language
  • Regulatory impact studies: Use the changes feed to measure legislative amendment frequency
  • Comparative law: Contrast UK statutory instruments with primary legislation structure
  • Brexit research: Analyse retained EU legislation (type eur) and its UK modifications

Python Usage

import requests
from xml.etree import ElementTree as ET

BASE = "https://www.legislation.gov.uk"
NS = {"leg": "http://www.legislation.gov.uk/namespaces/legislation",
      "ukm": "http://www.legislation.gov.uk/namespaces/metadata",
      "dc": "http://purl.org/dc/elements/1.1/",
      "atom": "http://www.w3.org/2005/Atom"}

def get_legislation(leg_type: str, year: int, number: int) -> dict:
    """Fetch UK legislation metadata and full XML."""
    url = f"{BASE}/{leg_type}/{year}/{number}/data.xml"
    resp = requests.get(url)
    resp.raise_for_status()
    root = ET.fromstring(resp.content)
    meta = root.find(".//ukm:Metadata", NS)
    return {
        "title": meta.findtext("dc:title", namespaces=NS),
        "description": meta.findtext("dc:description", namespaces=NS),
        "provisions": root.attrib.get("NumberOfProvisions"),
        "extent": root.attrib.get("RestrictExtent"),
        "uri": root.attrib.get("DocumentURI"),
        "xml": resp.content
    }

# Example: fetch the Equality Act 2010
act = get_legislation("ukpga", 2010, 15)
print(f"{act['title']} — {act['provisions']} provisions, extent: {act['extent']}")
# Output: Equality Act 2010 — 564 provisions, extent: E+W+S+N.I.

References