Skip to main content
POST
Change of Name Certificate
Verify an Australian change of name certificate against the Registry of Births, Deaths and Marriages in the state or territory that registered it. Submit both the previous and the new name, along with the registration details and the person’s date of birth. This check links an earlier identity record to a current one.

Reading the result

Check data.isValid to determine whether the submitted details match the issuing agency’s records. A no-match still returns HTTP 200 with success: true — see Introduction to Australia DVS for how to interpret verificationStatus.

Sandbox test data

Change of Name Certificate sandbox payloads

Copy-paste payloads for every outcome.

Authorizations

Authorization
string
header
required

Use your API token as a Bearer token in the Authorization header.

Headers

Authorization
string
required
Example:

"Bearer {your_api_token}"

Accept
string
default:application/json
Content-Type
string
default:application/json

Body

application/json
familyName
string
required

Family name before the change.

givenName
string
required

Given name(s) before the change.

dob
string
required

Date of birth in DD-MM-YYYY format.

Example:

"15-03-1990"

registrationNumber
string
required

Change of name registration number.

registrationState
string
required

State that registered the change of name.

Example:

"NSW"

registrationDate
string
required

Date the change of name was registered in DD-MM-YYYY format.

Example:

"10-01-2015"

certificateNumber
string
required

Certificate number.

familyName2
string

Family name after the change.

givenName2
string

Given name(s) after the change.

registrationYear
string

Year the change of name was registered.

datePrinted
string

Date the certificate was printed in DD-MM-YYYY format.

metadata
object

Optional key-value pairs echoed back in the response.

Response

Request processed. Check data.isValid and verificationStatus to determine the outcome.

success
boolean
required
message
string
required
data
object
required
verificationStatus
enum<string>
required
Available options:
VERIFIED,
REJECTED
verificationStatusCode
integer
required

3 = Verified, 1 = Rejected.

transactionId
string<uuid>
required
verificationType
string
required
Example:

"australia_change_of_name_certificate"

createdAt
string
required
metadata
object | null