Erskine May API

APIProfiled3/7PreviewSubscribe🇬🇧United Kingdom

This API provides programmatic access to Erskine May, the authoritative treatise on UK parliamentary practice and procedure, published by UK Parliament. It allows users to query the text and structure of the work, which is used as a reference guide for the rules and conventions governing proceedings in the House of Commons. Free and requiring no authentication, the API is accessible via the UK Parliament website and is intended for developers and researchers seeking structured access to parliamentary procedural material.An API that allows querying of Erskine May data.

legislation

Run verified request OpenAPI spec API base URL Visit homepage

Trust score

How is this computed?

good

Weighted across five axes. Tap a ring for what it measures.

Data schema (43 fields)

Filterable via the API (10)

chapterNumberstartLetterskiptakeindexTermIdpartNumbersearchTermreferencesectionIdstep

Field	Type	Description
chapterNumberChapter number	integer (int32)	Chapter number used to retrieve its overview.Chapter overview with the chapter number specified
startLetterStart letter	string	Filters index terms by their starting letter.Index terms by start letter
skip	integer (int32)	Number of records to skip from the start, default 0.The number of records to skip from the first, default is 0.
take	integer (int32)	Number of records to return, default 20, maximum 20.The number of records to return, default is 20, maximum is 20.
indexTermIdIndex term id	integer (int32)	Identifier used to look up a specific index term.Index term by if
partNumberPart number	integer (int32)	Part number used to retrieve a specific part.Part by part number
searchTermSearch term	string	Text used to filter index terms containing this term.Index terms which contain search term.
reference	string	Reference code used to look up a section overview.Section overview by reference.
sectionIdSection id	integer (int32)	Identifier used to retrieve a specific section.Section by id.
step	integer (int32)	Number of sections to move forward or back from a given section.Number of sections to step over from given section.
numberErskineMayChapterOverview	integer (int32)	Chapter number within the Erskine May text.Chapter number within the Erskine May text.
titleErskineMayChapterOverview	string	Title of the chapter.Title of the chapter.
descriptionErskineMayChapterOverview	string	Short description or overview of the chapter.Short description or overview of the chapter.
sectionsErskineMayChapterOverview	array<object>	List of sections belonging to the chapter.List of sections belonging to the chapter.
contentErskineMayFootnote	string	Text content of the footnote.Text content of the footnote.
idErskineMayIndexTerm	integer (int32)	Unique identifier of the index term.Unique identifier of the index term.
termErskineMayIndexTerm	string	The indexed term text.The indexed term text.
displayAsErskineMayIndexTerm	string	Text used to display the index term.Text used to display the index term.
seeLinksErskineMayIndexTerm	array<object>	List of cross-reference links from this index term.List of cross-reference links from this index term.
referencesErskineMayIndexTerm	array<object>	List of references associated with the index term.List of references associated with the index term.
parentTermErskineMayIndexTerm	object	The parent index term, if this term is nested.The parent index term, if this term is nested.
childTermsErskineMayIndexTerm	array<object>	List of child index terms nested under this term.List of child index terms nested under this term.
seeValueErskineMayIndexTermSearchResult	string	Displayed value for a cross-reference search result.Displayed value for a cross-reference search result.
totalResultsErskineMayIndexTermSearchResultErskineMaySearch	integer (int32)	Total number of matching search results.Total number of matching search results.
searchResultsErskineMayIndexTermSearchResultErskineMaySearch	array<object>	List of index term search result items.List of index term search result items.
searchTermsErskineMayIndexTermSearchResultErskineMaySearch	array<string>	List of search terms used or matched in the query.List of search terms used or matched in the query.
suggestedSearchErskineMayIndexTermSearchResultErskineMaySearch	string	Suggested alternative search term.Suggested alternative search term.
seeTypeErskineMayIndexTermSeeLink	string	Type of cross-reference indicated by the see link.Type of cross-reference indicated by the see link.
paragraphReferenceErskineMayParagraphSearchResult	string	Reference identifying the matched paragraph.Reference identifying the matched paragraph.
searchResultTextErskineMayParagraphSearchResult	string	Text excerpt from the matched paragraph.Text excerpt from the matched paragraph.
sectionTitleErskineMayParagraphSearchResult	string	Title of the section containing the match.Title of the section containing the match.
sectionTitleChainErskineMayParagraphSearchResult	string	Hierarchical chain of section titles leading to this section.Hierarchical chain of section titles leading to this section.
chapterTitleErskineMayParagraphSearchResult	string	Title of the chapter containing the match.Title of the chapter containing the match.
chaptersErskineMayPart	array<object>	List of chapters belonging to the part.List of chapters belonging to the part.
titleChainErskineMaySectionDetail	string	Hierarchical chain of titles leading to this section.Hierarchical chain of titles leading to this section.
subSectionsErskineMaySectionDetail	array<object>	List of subsections nested under this section.List of subsections nested under this section.
parentSectionIdErskineMaySectionDetail	integer (int32)	Identifier of the parent section, if any.Identifier of the parent section, if any.
parentSectionTitleErskineMaySectionDetail	string	Title of the parent section, if any.Title of the parent section, if any.
partTitleErskineMaySectionDetail	string	Title of the part containing this section.Title of the part containing this section.
contentHtmlErskineMaySectionDetail	string	HTML-formatted content of the section.HTML-formatted content of the section.
isUpdatedErskineMaySectionDetail	boolean	Indicates whether the section has been recently updated.Indicates whether the section has been recently updated.
updatedDateErskineMaySectionDetail	string (date-time)	Date and time the section was last updated.Date and time the section was last updated.
footnotesErskineMaySectionDetail	array<object>	List of footnotes associated with the section.List of footnotes associated with the section.

Schema captured from openapi 22 days ago.

Verification Status

Using the API

Configuration

Base URL: https://erskinemay-api.parliament.uk
Version: v1
Format: openapi
Endpoints: 11

Try the API

GET/api/Chapter/{chapterNumber}

Returns a single chapter overview by chapter number.

GET/api/IndexTerm/browse

Returns a list of index terms by start letter.

GET/api/IndexTerm/{indexTermId}

Returns an index term by id.

GET/api/Part

Returns a list of all parts.

GET/api/Part/{partNumber}

Returns a part by part number.

Requests are proxied through our servers. Only GET endpoints are testable.

Endpoints (11)

/api11 endpoints

GET

/api/Chapter/{chapterNumber}

Returns a single chapter overview by chapter number.

GET

/api/IndexTerm/browse

Returns a list of index terms by start letter.

GET

/api/IndexTerm/{indexTermId}

Returns an index term by id.

GET

/api/Part

Returns a list of all parts.

GET

/api/Part/{partNumber}

Returns a part by part number.

GET

/api/Search/IndexTermSearchResults/{searchTerm}

Returns a list of index terms which contain the search term.

GET

/api/Search/Paragraph/{reference}

Returns a section overview by reference.

GET

/api/Search/ParagraphSearchResults/{searchTerm}

Returns a list of paragraphs which contain the search term.

GET

/api/Search/SectionSearchResults/{searchTerm}

Returns a list of sections which contain the search term.

GET

/api/Section/{sectionId}

Returns a section by section id.

GET

/api/Section/{sectionId},{step}

Returns a section overview by section id and step.

Query examples

curl -s 'https://erskinemay-api.parliament.uk/swagger/v1/swagger.json' -H 'Accept: application/json'

Machine-readable API description (use it to generate clients).

Machine-readable & source

OpenAPI spec JSON GitHub

Embed this badge in a README or wiki — it always shows the latest verification state and quality tier.