---
title: "Search for death records"
method: GET
path: "/v1/registration/death"
tags: ["death", "v1", "unstable"]
---

# Search for death records

`GET /v1/registration/death`

## Request

- Base URL: `https://api.lev.homeoffice.gov.uk`
- URL: `https://api.lev.homeoffice.gov.uk/v1/registration/death`
- Auth: OAuth 2
  - Authorization code: `https://sso.digital.homeoffice.gov.uk/auth/realms/lev/protocol/openid-connect/auth`
  - Token URL: `https://sso.digital.homeoffice.gov.uk/auth/realms/lev/protocol/openid-connect/token`
- TypeScript: <https://skmtc.dev/home-office/apis/life-event-verification-lev-api/docs/v1/registration/death/get.ts> (a function with typed inputs; its response is checked against the schema)

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.)

## Query parameters

- `forenames` string, required
- `surname` string, required
- `date` string, date, required

## Response `200`

successful operation

- V1Death[]
  - `id` integer, required: System number for this event
  - `date` string, date, required: Date the death was registered
  - `deceased` object, required: The person that died
    - `forenames` string, required: Forenames of the deceased
    - `surname` string, required: Surname of the deceased
    - `dateOfBirth` string, date: Date the deceased was born
    - `dateOfDeath` string, date, required: Date the person died
    - `sex` 'Male' | 'Female' | 'Indeterminate', required: Sex of the deceased
    - `birthplace` string: The birthplace of the deceased
    - `deathplace` string: The place the person died
    - `occupation` string: The occupation of the deceased
    - `address` string: The deceased's address
    - `retired` boolean: Whether the deceased was retired
    - `maidenSurname` string: Maiden name of the deceased
  - `status` object, required: Status flags associated with this record
    - `blocked` boolean, required: Indicates if data for this record has been blocked

## Other responses

- `default`: Bad request

## Changes

- **2020-04-08** `4024e12e04b5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/home-office/apis/life-event-verification-lev-api/changes/v1/registration/death/get.md)

---

[API](https://skmtc.dev/home-office/apis/life-event-verification-lev-api.md) - [All operations](https://skmtc.dev/home-office/apis/life-event-verification-lev-api/llms.txt) - [OpenAPI document](https://skmtc.dev/home-office/apis/life-event-verification-lev-api/revisions/555f7dc044af?raw)