{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"uk-legislation.schema.json","title":"UK legislation item from legislation.gov.uk (Act or statutory instrument of the UK, Scotland, Wales or Northern Ireland)","description":"Source: legislation.gov.uk, The National Archives. Contains public sector information licensed under the Open Government Licence v3.0. Metadata only; the text on legislation.gov.uk is the official version.","type":"object","required":["id","type","type_name","category","legislature","year","number","alternative_numbers","isbn","title","summary","enacted_or_made","made_date","laid_date","coming_into_force","coming_into_force_dates","extent","subjects","publisher","department","supersedes_draft","published","updated","url","pdf_url","detail_retrieved","verification","paid_placement","source_id","source_url","retrieved_at"],"additionalProperties":false,"properties":{"id":{"type":"string","pattern":"^(ukpga|uksi|asp|ssi|asc|anaw|wsi|nia|nisr)/\\d{4}/\\d+$","description":"legislation.gov.uk identifier: type/year/number, for example uksi/2026/1171 or ukpga/2025/1"},"type":{"enum":["ukpga","uksi","asp","ssi","asc","anaw","wsi","nia","nisr"],"description":"legislation.gov.uk short type code: ukpga UK Public General Act, uksi UK Statutory Instrument, asp Act of the Scottish Parliament, ssi Scottish Statutory Instrument, asc Act of Senedd Cymru, anaw Act of the National Assembly for Wales, wsi Welsh Statutory Instrument, nia Act of the Northern Ireland Assembly, nisr Northern Ireland Statutory Rule"},"type_name":{"type":"string","description":"Full name of the legislation type"},"category":{"enum":["primary","secondary"],"description":"primary (Acts) or secondary (statutory instruments and rules)"},"legislature":{"enum":["united-kingdom","scotland","wales","northern-ireland"],"description":"Legislature or administration the item belongs to"},"year":{"type":"integer","description":"Calendar year of enactment or registration"},"number":{"type":"integer","description":"Number in the primary numbering series of the type (chapter number for Acts, SI number for instruments)"},"alternative_numbers":{"type":"array","items":{"type":"string"},"description":"Numbers in other series, for example C. 44 (commencement order), W. 191 (Welsh), S. 5 (Scottish), L. 3 (legal procedure)"},"isbn":{"type":["string","null"],"description":"ISBN of the printed edition, where given"},"title":{"type":"string","description":"Official title"},"summary":{"type":["string","null"],"description":"Official long title or explanatory summary as published on legislation.gov.uk, where given"},"enacted_or_made":{"type":["string","null"],"description":"Date of Royal Assent (Acts) or date made (instruments), ISO 8601; null when not yet recorded","format":"date"},"made_date":{"type":["string","null"],"description":"Date made (instruments), from the item metadata; null for Acts or when the detail was not fetched","format":"date"},"laid_date":{"type":["string","null"],"description":"Date laid before Parliament or the devolved legislature, where given","format":"date"},"coming_into_force":{"type":["string","null"],"description":"Earliest coming into force date given in the item metadata (ISO 8601); null when not given, for example when commencement is by later order","format":"date"},"coming_into_force_dates":{"type":"array","items":{"type":"string"},"description":"All coming into force dates given in the item metadata (ISO 8601)"},"extent":{"type":"array","items":{"enum":["England","Wales","Scotland","Northern Ireland"]},"description":"Geographical extent from the provisions of the enacted or made version; empty when not given or the detail was not fetched"},"subjects":{"type":"array","items":{"type":"string"},"description":"Subject headings given by the publisher, for example PENSIONS or AGRICULTURE, ENGLAND"},"publisher":{"type":["string","null"],"description":"Publisher of the official version, for example King's Printer of Acts of Parliament or King's Printer for Scotland"},"department":{"type":["string","null"],"description":"Government department named on the published impact assessment, where one is published with the item"},"supersedes_draft":{"type":["string","null"],"description":"legislation.gov.uk identifier URI of the draft instrument this item supersedes, where given"},"published":{"type":"string","format":"date","description":"Date of first publication on legislation.gov.uk (ISO 8601)"},"updated":{"type":"string","format":"date","description":"Date of the latest change to the item on legislation.gov.uk, including new revised versions (ISO 8601)"},"url":{"type":"string","format":"uri","description":"legislation.gov.uk page of the item (latest available version)"},"pdf_url":{"type":["string","null"],"description":"PDF of the item on legislation.gov.uk: the original print PDF where available, otherwise the PDF of the latest revised version","format":"uri"},"detail_retrieved":{"type":["string","null"],"description":"When the item metadata (dates, extent, publisher, department) was last fetched from the table of contents XML; null when only the feed entry is known (for example items published as PDF only)","format":"date-time"},"verification":{"const":"official-publication","description":"Metadata of the official publication on legislation.gov.uk, The National Archives"},"paid_placement":{"const":false,"description":"Always false: no record is paid for or promoted"},"source_id":{"enum":["legislation-gov-uk-feeds"]},"source_url":{"type":"string","description":"legislation.gov.uk identifier URI of the item"},"retrieved_at":{"type":"string","format":"date-time"}}}