UK Premises Licensing API

Licensing Act 2003 premises licences and club premises certificates from council licensing registers, in one schema: licence reference, type and status, premises name and address, licensable activities, permitted hours, grant, variation and expiry dates where printed, and the licence holder when it is an organisation. Served by the Olympus Go gateway.

As published. Each council publishes its register in its own way: an open-data file (CSV, XLSX or JSON listed in a data catalogue) or a PDF register at a stable address. Values are as printed, mapped onto one schema. status, licence_type and activities are normalised from the printed values (derived), and status_as_published, licence_type_as_published and activities_as_published keep what was printed. Nothing is inferred, and no language model is used.

Organisations, not people. This API publishes premises, not people:

• Designated premises supervisors (always individuals), personal licences and temporary event notices are never loaded.
• Holders' own home or correspondence addresses, phone numbers and e-mail addresses are never read.
• A licence holder is published only when it is an organisation on firm evidence: a Companies House number printed by the council (companies_house_number), an exact match to a registered company name (companies_house_name), a legal form ending the name such as Ltd, Limited, PLC, LLP or CIC (legal_form_suffix), or a body that is never a natural person, such as a council, NHS body, university, school, trust, church or registered charity (organisational_form). Anything else, including "Mr", "t/a" forms and several named holders, is withheld: holder.name is null, holder.withheld is true and holder.withheld_reason says why.
• Premises that appear to be private dwellings (the premises address is the holder's own address, or a flat with a withheld holder and no trading name) are excluded and counted in coverage.

Every response repeats this in meta.notices (organisations_only).

Provenance. Every licence carries field_provenance: for each field, where it was read (the file's row number and column, or the PDF page, box and printed text) and the printed text. provenance names the source, the retained file's SHA-256 and the publication. PDF rows are published only when every check passed for the document and the row was read cleanly; rows held for OCR review are counted in coverage and never served.

Coverage. Only the councils GET /v1/uk-premises-licensing/coverage lists as published. Each source's licence is listed as the council states it; only sources whose terms allow commercial reuse (the Open Government Licence or equivalent) are included. Councils are identified by their ONS GSS code, checked against the ONS names and codes lists at every load.

Pagination. GET /licences pages with a cursor (meta.pagination.next_cursor; pass it back unchanged with the same filters). A cursor is tied to the publication it was issued under.

Authenticate with an API key in X-API-Key or Authorization: Bearer. The organization's plan must include uk-premises-licensing. Every response carries X-Request-Id. Errors share the Error body.