Life Event Verification (LEV) API reference

A ReSTful API for verifying 'life events' such as births, deaths and marriages.

Getting started

To get started using the API we recommend first experimenting with the mock API. All the methods described here can be called without the need to first be on-boarded.

On-boarding and authentication

In order for you to use the LEV API your department will need to have an agreement with us (HMPO). Provided you have that you will be able to follow the technical steps to on-board and authenticate with the service.

Birth records

Look up and search for birth records. Individual birth records can be looked up using the systemNumber printed in the bottom-left of the birth certificate. Alternatively, it is possible to search for birth records by supplying the date of birth, surname and at least the first forename of the child.

GET /api/v0/events/birth

GET /v1/registration/birth/{id}

GET /v1/registration/birth

GET /api/v0/events/birth/{systemNumber}

Death records

GET /v1/registration/death

GET /v1/registration/death/{id}

Marriage records

GET /v1/registration/marriage/{id}

GET /v1/registration/marriage

Civil partnership records

GET /v1/registration/partnership

GET /v1/registration/partnership/{id}