Search for marriage records by supplying the date of marriage as well as the surname and at least the first forename of one of the partners. (UNSTABLE: This endpoint is subject to change.)

Request

GET https://api.lev.homeoffice.gov.uk/v1/registration/marriage

Query parameters

Parameter name Value Description Additional
forenames string

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

Required
surname string

The person's surname.

Required
dateOfMarriage date

The date of the marriage 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

Marriage record (v1)
default

Bad request

Error

Explore this API

forenames

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

surname

The person's surname.

dateOfMarriage

The date of the marriage in international format.

Response Content-Type

Choose an authorisation method:

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