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

# Search for civil partnership records

`GET /v1/registration/partnership`

## Request

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

Search for civil partnership records by supplying the date of the civil partnership 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
- `dateOfPartnership` string, date, required

## Response `200`

successful operation

- V1Partnership[]
  - `id` integer, required: System number for this event
  - `dateOfPartnership` string, date, required: Date of the civil partnership
  - `partner1` object, required: The first partner
    - `forenames` string, required: Forenames of the person
    - `surname` string, required: Surname of the person
    - `dateOfBirth` string, date: Date the person was born
    - `sex` 'Male' | 'Female' | 'Indeterminate': Sex of the person
    - `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
  - `partner2` object, required: The second partner
    - `forenames` string, required: Forenames of the person
    - `surname` string, required: Surname of the person
    - `dateOfBirth` string, date: Date the person was born
    - `sex` 'Male' | 'Female' | 'Indeterminate': Sex of the person
    - `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** `1ec736a929c8`: 1 info
  - endpoint added

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