---
title: "Look up a specific death record"
method: GET
path: "/v1/registration/death/{id}"
tags: ["death", "v1", "unstable"]
---

# Look up a specific death record

`GET /v1/registration/death/{id}`

## Request

- Base URL: `https://api.lev.homeoffice.gov.uk`
- URL: `https://api.lev.homeoffice.gov.uk/v1/registration/death/{id}`
- 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/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Look up individual death records using the `systemNumber` printed in the bottom-left of the death certificate. (UNSTABLE: This endpoint is subject to change.)

## Path parameters

- `id` integer, required

## Response `200`

successful operation

- V1Death: A record of a death (Note: You will only receive the fields you are authorized to view, regardless of whether we hold them on file)
  - `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

- `404`: Resource not found
- `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/:id/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)