Quick start guide
Find the base URL for a register
Find the base URL for a register on its API inspector. For example, the API
inspector for the
local-authority-eng register is located at
The following are some examples of base URLs:
|Register ID||Base URL|
Append the current version of the API
The current version of the API is
You should add the version of the API you want to use to the end of the base URL. This step is optional for version 1 of the API and will become required when version 1 is no longer supported.
For example, the full base URL for
v1 of the
local-authority-eng register is
See version history for the full list of versions.
Choose an endpoint
You can use endpoints as described in the API reference section.
Choose a response format
Choose a response format by adding the appropriate suffix to the request URL:
You can also specify a format by making a request with the
Accept header. For example:
curl https://country.register.gov.uk/records/GB --header 'Accept: application/json'
To paginate you should always rely on the