Search for death records by supplying the surname, at least the first forename and either the date of birth or the date of death of the deceased. (UNSTABLE: This endpoint is subject to change.)

Request

GET https://api.qa.notprod.lev.homeoffice.gov.uk/v1/registration/death

Query parameters

Parameter name Value Description Additional
forenames string

The deceased's forenames. The first name must be provided but middlenames are optional.

Required
surname string

The deceased's surname.

Required
date date

The deceased's date of birth or death in international format.

Required

Authorisation

This request requires the use of one of following authorisation methods: OAuth2.

Response

The following HTTP status codes may be returned, optionally with a response resource.

Status code Description Resource
200 OK

successful operation

Death record (v1)
default

Bad request

Error

Explore this API

forenames

The deceased's forenames. The first name must be provided but middlenames are optional.

surname

The deceased's surname.

date

The deceased's date of birth or death in international format.

Response Content-Type

Choose an authorisation method:

Access Token Access token to be used for request
Try it out!