Change of Name Certificate

curl --request POST \
  --url https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/australia-change-of-name-certificate-passthrough \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "familyName": "Smith",
  "givenName": "Jordan",
  "dob": "15-03-1990",
  "registrationNumber": "123456",
  "registrationState": "NSW",
  "registrationDate": "10-01-2015",
  "certificateNumber": "987654321"
}
'

import requests

url = "https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/australia-change-of-name-certificate-passthrough"

payload = {
    "familyName": "Smith",
    "givenName": "Jordan",
    "dob": "15-03-1990",
    "registrationNumber": "123456",
    "registrationState": "NSW",
    "registrationDate": "10-01-2015",
    "certificateNumber": "987654321"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    familyName: 'Smith',
    givenName: 'Jordan',
    dob: '15-03-1990',
    registrationNumber: '123456',
    registrationState: 'NSW',
    registrationDate: '10-01-2015',
    certificateNumber: '987654321'
  })
};

fetch('https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/australia-change-of-name-certificate-passthrough', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/australia-change-of-name-certificate-passthrough",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'familyName' => 'Smith',
    'givenName' => 'Jordan',
    'dob' => '15-03-1990',
    'registrationNumber' => '123456',
    'registrationState' => 'NSW',
    'registrationDate' => '10-01-2015',
    'certificateNumber' => '987654321'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/australia-change-of-name-certificate-passthrough"

	payload := strings.NewReader("{\n  \"familyName\": \"Smith\",\n  \"givenName\": \"Jordan\",\n  \"dob\": \"15-03-1990\",\n  \"registrationNumber\": \"123456\",\n  \"registrationState\": \"NSW\",\n  \"registrationDate\": \"10-01-2015\",\n  \"certificateNumber\": \"987654321\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/australia-change-of-name-certificate-passthrough")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"familyName\": \"Smith\",\n  \"givenName\": \"Jordan\",\n  \"dob\": \"15-03-1990\",\n  \"registrationNumber\": \"123456\",\n  \"registrationState\": \"NSW\",\n  \"registrationDate\": \"10-01-2015\",\n  \"certificateNumber\": \"987654321\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/australia-change-of-name-certificate-passthrough")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"familyName\": \"Smith\",\n  \"givenName\": \"Jordan\",\n  \"dob\": \"15-03-1990\",\n  \"registrationNumber\": \"123456\",\n  \"registrationState\": \"NSW\",\n  \"registrationDate\": \"10-01-2015\",\n  \"certificateNumber\": \"987654321\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "Australia Change of Name Certificate processed successfully",
  "data": {
    "isValid": true
  },
  "verificationStatus": "VERIFIED",
  "verificationStatusCode": 3,
  "transactionId": "79b6f81c-fc48-42ce-b907-763129b0957e",
  "verificationType": "australia_change_of_name_certificate",
  "metadata": {
    "yourRef": "testCase-9002"
  },
  "createdAt": "2026-08-27 02:49:30+0000"
}

POST

api

verifications

australia-change-of-name-certificate-passthrough

Change of Name Certificate

curl --request POST \
  --url https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/australia-change-of-name-certificate-passthrough \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "familyName": "Smith",
  "givenName": "Jordan",
  "dob": "15-03-1990",
  "registrationNumber": "123456",
  "registrationState": "NSW",
  "registrationDate": "10-01-2015",
  "certificateNumber": "987654321"
}
'

import requests

url = "https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/australia-change-of-name-certificate-passthrough"

payload = {
    "familyName": "Smith",
    "givenName": "Jordan",
    "dob": "15-03-1990",
    "registrationNumber": "123456",
    "registrationState": "NSW",
    "registrationDate": "10-01-2015",
    "certificateNumber": "987654321"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    familyName: 'Smith',
    givenName: 'Jordan',
    dob: '15-03-1990',
    registrationNumber: '123456',
    registrationState: 'NSW',
    registrationDate: '10-01-2015',
    certificateNumber: '987654321'
  })
};

fetch('https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/australia-change-of-name-certificate-passthrough', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/australia-change-of-name-certificate-passthrough",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'familyName' => 'Smith',
    'givenName' => 'Jordan',
    'dob' => '15-03-1990',
    'registrationNumber' => '123456',
    'registrationState' => 'NSW',
    'registrationDate' => '10-01-2015',
    'certificateNumber' => '987654321'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/australia-change-of-name-certificate-passthrough"

	payload := strings.NewReader("{\n  \"familyName\": \"Smith\",\n  \"givenName\": \"Jordan\",\n  \"dob\": \"15-03-1990\",\n  \"registrationNumber\": \"123456\",\n  \"registrationState\": \"NSW\",\n  \"registrationDate\": \"10-01-2015\",\n  \"certificateNumber\": \"987654321\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/australia-change-of-name-certificate-passthrough")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"familyName\": \"Smith\",\n  \"givenName\": \"Jordan\",\n  \"dob\": \"15-03-1990\",\n  \"registrationNumber\": \"123456\",\n  \"registrationState\": \"NSW\",\n  \"registrationDate\": \"10-01-2015\",\n  \"certificateNumber\": \"987654321\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/australia-change-of-name-certificate-passthrough")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"familyName\": \"Smith\",\n  \"givenName\": \"Jordan\",\n  \"dob\": \"15-03-1990\",\n  \"registrationNumber\": \"123456\",\n  \"registrationState\": \"NSW\",\n  \"registrationDate\": \"10-01-2015\",\n  \"certificateNumber\": \"987654321\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "Australia Change of Name Certificate processed successfully",
  "data": {
    "isValid": true
  },
  "verificationStatus": "VERIFIED",
  "verificationStatusCode": 3,
  "transactionId": "79b6f81c-fc48-42ce-b907-763129b0957e",
  "verificationType": "australia_change_of_name_certificate",
  "metadata": {
    "yourRef": "testCase-9002"
  },
  "createdAt": "2026-08-27 02:49:30+0000"
}

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}"

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

Show child attributes

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

API documentation

Australia DVS

Change of Name Certificate

Authorizations

Headers

Body

Response