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|
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'
API calls on resource collections are paginated. Follow the specific guidance
for each endpoint to get the page(s) of entries and records you need. For
example, to paginate the records’ collection use
page-size to define the
amount of elements you want per page and
page-index to define the page you
want to get. The maximum
page-size is 5000.