Treaties API

APIProfiled3/7PreviewSubscribe🇬🇧United Kingdom

This API provides access to details of treaties laid before the UK Parliament, maintained by UK Parliament. It exposes structured data on treaty records, including their status and progress through the parliamentary scrutiny process, allowing developers and researchers to programmatically track and analyse treaties formally presented to Parliament. Access is free and does not require authentication. It is part of a broader set of parliamentary data services published by UK Parliament covering legislative and procedural information at the national level for the United Kingdom.An API exposing details of the treaties laid before Parliament.

legislation

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 (55 fields)

Filterable via the API (11)

idSearchTextGovernmentOrganisationIdSeriesParliamentaryProcessDebateScheduledMotionsTabledAboutATreatyCommitteeRaisedConcernsHouseSkipTake

Field	Type	Description
id	string	Unique identifier of the business item.Business item with the ID specified
SearchTextSearch text	string	Free-text search term for filtering treaty records.Free-text search term for filtering treaty records.
GovernmentOrganisationIdGovernment organisation id	integer (int32)	Identifier of the government organisation associated with the treaty.Identifier of the government organisation associated with the treaty.
Series	string	Name of the treaty series to filter by.Name of the treaty series to filter by.
ParliamentaryProcessParliamentary process	string	Parliamentary process type to filter treaties by.Parliamentary process type to filter treaties by.
DebateScheduledDebate scheduled	boolean	Whether a debate has been scheduled for the treaty.Whether a debate has been scheduled for the treaty.
MotionsTabledAboutATreatyMotions tabled about atreaty	boolean	Whether motions have been tabled about the treaty.Whether motions have been tabled about the treaty.
CommitteeRaisedConcernsCommittee raised concerns	boolean	Whether a committee has raised concerns about the treaty.Whether a committee has raised concerns about the treaty.
House	string	House of Parliament to filter results by.House of Parliament to filter results by.
Skip	integer (int32)	Number of records to skip for pagination.Number of records to skip for pagination.
Take	integer (int32)	Maximum number of records to return.Maximum number of records to return.
treatyIdBusinessItem	string	Identifier of the treaty related to this business item.Identifier of the treaty related to this business item.
stepNameBusinessItem	string	Name of the procedural step for this business item.Name of the procedural step for this business item.
stepsBusinessItem	array<string>	List of procedural steps associated with the business item.List of procedural steps associated with the business item.
itemDateBusinessItem	string (date-time)	Date associated with the business item.Date associated with the business item.
housesBusinessItem	array<object>	Houses of Parliament involved in the business item.Houses of Parliament involved in the business item.
linkBusinessItem	string	URL link related to the business item.URL link related to the business item.
sequenceBusinessItem	integer (int32)	Order sequence number of the business item.Order sequence number of the business item.
treatyUriBusinessItem	string (uri)	URI of the related treaty resource.URI of the related treaty resource.
businessItemUriBusinessItem	string (uri)	URI of the business item resource.URI of the business item resource.
houseUriBusinessItem	string (uri)	URI of the associated house resource.URI of the associated house resource.
houseNameBusinessItem	string	Name of the House of Parliament involved.Name of the House of Parliament involved.
procedureStepUriBusinessItem	string (uri)	URI of the associated procedure step resource.URI of the associated procedure step resource.
houseIdBusinessItem	string	Identifier of the House of Parliament.Identifier of the House of Parliament.
procedureStepIdBusinessItem	string	Identifier of the procedural step.Identifier of the procedural step.
workpackageProcedureUriBusinessItem	string (uri)	URI of the related workpackage procedure resource.URI of the related workpackage procedure resource.
houseBusinessItemHouse	object	House of Parliament object associated with the business item.House of Parliament object associated with the business item.
nameBusinessItemHouse	string	Name of the house.Name of the house.
valueBusinessItemResource	object	Main resource content of the business item.Main resource content of the business item.
linksBusinessItemResource	array<object>	List of related hyperlinks for the resource.List of related hyperlinks for the resource.
itemsBusinessItemResourceCollection	array<object>	List of business item resources in the collection.List of business item resources in the collection.
totalResultsBusinessItemResourceCollection	integer (int32)	Total number of results available.Total number of results available.
itemsPerPageBusinessItemResourceCollection	integer (int32)	Number of items returned per page.Number of items returned per page.
descriptionSeriesMembership	string	Description text for the series membership.Description text for the series membership.
uriTreaty	string (uri)	URI identifying the treaty resource.URI identifying the treaty resource.
commandPaperPrefixTreaty	string	Prefix code of the treaty's command paper.Prefix code of the treaty's command paper.
commandPaperNumberTreaty	integer (int32)	Number of the treaty's command paper.Number of the treaty's command paper.
commonsLayingDateTreaty	string (date-time)	Date the treaty was laid before the House of Commons.Date the treaty was laid before the House of Commons.
lordsLayingDateTreaty	string (date-time)	Date the treaty was laid before the House of Lords.Date the treaty was laid before the House of Lords.
webLinkTreaty	string (uri)	URL to further information about the treaty.URL to further information about the treaty.
treatySeriesMembershipTreaty	object	Details of the treaty's membership in a treaty series.Details of the treaty's membership in a treaty series.
leadDepartmentTreaty	object	Government department responsible for the treaty.Government department responsible for the treaty.
layingBodyDepartmentTreaty	object	Department that laid the treaty before Parliament.Department that laid the treaty before Parliament.
parliamentaryConclusionTreaty	object	Outcome of the treaty's parliamentary consideration.Outcome of the treaty's parliamentary consideration.
debateScheduledTreaty	string	Indicates whether a debate on the treaty is scheduled.Indicates whether a debate on the treaty is scheduled.
broughtToAttentionDateTreaty	string (date-time)	Date the treaty was brought to Parliament's attention.Date the treaty was brought to Parliament's attention.
signedDateTreaty	string (date-time)	Date the treaty was signed.Date the treaty was signed.
laidDateTreaty	string (date-time)	Date the treaty was laid before Parliament.Date the treaty was laid before Parliament.
pertinentDateTreaty	string (date-time)	Relevant date associated with the treaty's process.Relevant date associated with the treaty's process.
workpackageIdTreaty	string	Identifier of the workpackage linked to the treaty.Identifier of the workpackage linked to the treaty.
seriesMembershipTypeTreatySeriesMembership	object	Type of treaty series membership.Type of treaty series membership.
citationTreatySeriesMembership	string	Citation reference for the treaty series membership.Citation reference for the treaty series membership.
relLink	string	Relationship type of the linked resource.Relationship type of the linked resource.
hrefLink	string	URL of the linked resource.URL of the linked resource.
methodLink	string	HTTP method used for the linked resource.HTTP method used for the linked resource.

Schema captured from openapi 23 days ago.

Verification Status

Using the API

Configuration

Base URL: https://treaties-api.parliament.uk
Version: v1
Format: openapi
Endpoints: 6

Try the API

GET/api/BusinessItem/{id}

Returns business item by ID.

GET/api/GovernmentOrganisation

Returns all government organisations.

GET/api/SeriesMembership

Returns all series memberships.

GET/api/Treaty

Returns a list of treaties.

GET/api/Treaty/{id}

Returns a treaty by ID.

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

Endpoints (6)

/api6 endpoints

GET

/api/BusinessItem/{id}

Returns business item by ID.

GET

/api/GovernmentOrganisation

Returns all government organisations.

GET

/api/SeriesMembership

Returns all series memberships.

GET

/api/Treaty

Returns a list of treaties.

GET

/api/Treaty/{id}

Returns a treaty by ID.

GET

/api/Treaty/{id}/BusinessItems

Returns business items belonging to the treaty with ID.

Query examples

curl -s 'https://treaties-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.