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

# Search for marriage records

`GET /v1/registration/marriage`

## Request

- Base URL: `https://api.lev.homeoffice.gov.uk`
- URL: `https://api.lev.homeoffice.gov.uk/v1/registration/marriage`
- 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`

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

## Query parameters

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

## Response `200`

successful operation

- V1Marriage[]
  - `id` integer, required: System number for this event
  - `dateOfMarriage` string, date, required: Date of the marriage
  - `groom` object, required: The groom (or first partner)
    - `forenames` string, required: Forenames of the person
    - `surname` string, required: Surname of the person
    - `age` integer: Age of the person when they got married
    - `occupation` string: The occupation of the person
    - `retired` boolean: Whether the person was retired
    - `address` string: The person's address
    - `condition` string, required: Whether the person was single, divorced, widowed etc.
    - `signature` string: A digital representation of the person's signature
  - `bride` object, required: The bride (or second partner)
    - `forenames` string, required: Forenames of the person
    - `surname` string, required: Surname of the person
    - `age` integer: Age of the person when they got married
    - `occupation` string: The occupation of the person
    - `retired` boolean: Whether the person was retired
    - `address` string: The person's address
    - `condition` string, required: Whether the person was single, divorced, widowed etc.
    - `signature` string: A digital representation of the person's signature
  - `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** `440990a1eb2b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/home-office/apis/life-event-verification-lev-api/changes/v1/registration/marriage/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)
