birth
v1
unstable
Search for birth records
Changed onSearch for birth records by supplying the date of birth, surname and at least the first forename of the child. (UNSTABLE: This endpoint is subject to change.)
get/v1/registration/birth
Request
- Base URLhttps://api.lev.homeoffice.gov.uk
- AuthOAuth 2Authorization codehttps://sso.digital.homeoffice.gov.uk/auth/realms/lev/protocol/openid-connect/authToken URLhttps://sso.digital.homeoffice.gov.uk/auth/realms/lev/protocol/openid-connect/token
- TypeScripthttps://skmtc.dev/home-office/apis/life-event-verification-lev-api/docs/v1/registration/birth/get.tsA function with typed inputs. Its response is checked against the schema.
Query parameters
forenamesstring required
The child's forenames. The first name must be provided but middlenames are optional.
surnamestring required
The child's surname.
dateOfBirthstring date required
The child's date of birth in international format.
Response
successful operation
Example response
[
{
"date": "2011-08-09",
"child": {
"forenames": "Joan Narcissus Ouroboros",
"originalForenames": "John Narcissus Ouroboros",
"surname": "SMITH",
"dateOfBirth": "2011-08-08",
"sex": "Indeterminate",
"birthplace": "Kensington"
},
"mother": {
"forenames": "Joan Narcissus Ouroboros",
"surname": "SMITH",
"maidenSurname": "BLACK",
"marriageSurname": "WHITE",
"birthplace": "Kensington",
"occupation": "Carpenter",
"address": "34 Matriarchs Place, Mumstown, Mumford"
},
"father": {
"forenames": "Joan Narcissus Ouroboros",
"surname": "SMITH",
"birthplace": "Kensington",
"occupation": "Carpenter"
}
}
]Changes
- info
endpoint added
- info