---
title: "Search for birth records"
method: GET
path: "/api/v0/events/birth"
tags: ["birth", "v0"]
---

# Search for birth records

`GET /api/v0/events/birth`

## Request

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

Search for birth records by supplying the date of birth, surname and at least the first forename of the child.

## Query parameters

- `forenames` string, required
- `lastname` string, required
- `dateofbirth` string, date, required

## Response `200`

successful operation

- V0Birth[]
  - `date` string, date: Date of the event
  - `location` object, required: Location that the event happened at
    - `name` string: Name
    - `nameQualifier` string: Name qualifier
    - `registrationDistrict` string: Registration district
    - `subDistrict` string: Sub-district
    - `administrativeArea` string: Administrative area
  - `registrarSignature` string: Signature of registrar
  - `type` string: Type of the event
  - `id` integer, required: Unique ID for this event
  - `subjects` object, required: People involved, may have keys parent1,parent2,child
    - `child` object: Child
      - `name` object: Name of the person
        - `givenName` string: Given name of the person
        - `surname` string: Surname of the person
        - `fullName` string: Full name of the person
        - `qualifier` string: Details about how the full name was made
      - `birthplace` string: The birthplace of the person
      - `dateOfBirth` string, date: Date of birth of the person
      - `sex` 'Male' | 'Female' | 'Indeterminate': Sex of the person
      - `originalName` object: The name originally given to the person
        - `givenName` string: Given name of the person
        - `surname` string: Surname of the person
        - `fullName` string: Full name of the person
        - `qualifier` string: Details about how the full name was made
    - `father` object: Father
      - `name` object: Name of the person
        - `givenName` string: Given name of the person
        - `surname` string: Surname of the person
        - `fullName` string: Full name of the person
        - `qualifier` string: Details about how the full name was made
      - `birthplace` string: The birthplace of the person
      - `occupation` string: The occupation of the parent
    - `mother` object: Mother
      - `name` object: Name of the person
        - `givenName` string: Given name of the person
        - `surname` string: Surname of the person
        - `fullName` string: Full name of the person
        - `qualifier` string: Details about how the full name was made
      - `birthplace` string: The birthplace of the person
      - `occupation` string: The occupation of the parent
      - `maidenSurname` string: Maiden surname
      - `marriageSurname` string: Surname at marriage if different from maiden surname
      - `usualAddress` string: Usual address (if different from the place of child's birth)
    - `informant` object: Informant
      - `name` object: Name of the person
        - `givenName` string: Given name of the person
        - `surname` string: Surname of the person
        - `fullName` string: Full name of the person
        - `qualifier` string: Details about how the full name was made
      - `usualAddress` string: The usual address of the person, if different from the mother's
      - `qualification` string: The qualification of the informant
      - `signature` string: The signature of the informant
  - `systemNumber` integer: System number for this event
  - `status` object, required: Status flags associated with this birth
    - `blockedRegistration` boolean, required: Indicates if data for this record has been blocked
    - `cancelled` boolean: Indicates if record was cancelled
    - `potentiallyFictitiousBirth` boolean: Indicates if a birth may be fictitious
    - `reRegistered` 'None' | 'Father modified' | 'Father added' | 'Replacement registration' | 'Other' | 'Subsequently married': Describes if this is a re-registration and why it was needed
    - `correction` 'Typographical' | 'Simple clerical' | 'Complex clerical' | 'Error of fact' | 'None': Indicates if there has been a correction to this record
    - `marginalNote` 'Re-registered' | 'Court order in place' | 'Court order revoked' | 'Other' | 'None': Gives additional notes on a record
  - `previousRegistration` object, required: Details of the previous record, where one exists
    - `date` string, date: Date of the event
    - `systemNumber` integer: System number for this event

## Other responses

- `default`: Bad request

## Changes

- **2020-04-08** `5154b41e4e34`: 1 info
  - api tag `v0` added
- **2018-03-29** `f791b8a5d454`: 1 info
  - api operation id `findBirth` removed and replaced with `searchBirth`
- **2017-11-28** `bdec46ad2307`: 1 info
  - the endpoint scheme security `lev_auth` was removed from the API

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