AEC Electoral Roll

curl --request POST \
  --url https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/australia-aec-passthrough \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "dob": "15-03-1990",
  "familyName": "Smith",
  "state": "NSW",
  "postcode": "2000",
  "suburb": "Sydney"
}
'

import requests

url = "https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/australia-aec-passthrough"

payload = {
    "dob": "15-03-1990",
    "familyName": "Smith",
    "state": "NSW",
    "postcode": "2000",
    "suburb": "Sydney"
}
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({
    dob: '15-03-1990',
    familyName: 'Smith',
    state: 'NSW',
    postcode: '2000',
    suburb: 'Sydney'
  })
};

fetch('https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/australia-aec-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-aec-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([
    'dob' => '15-03-1990',
    'familyName' => 'Smith',
    'state' => 'NSW',
    'postcode' => '2000',
    'suburb' => 'Sydney'
  ]),
  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-aec-passthrough"

	payload := strings.NewReader("{\n  \"dob\": \"15-03-1990\",\n  \"familyName\": \"Smith\",\n  \"state\": \"NSW\",\n  \"postcode\": \"2000\",\n  \"suburb\": \"Sydney\"\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-aec-passthrough")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"dob\": \"15-03-1990\",\n  \"familyName\": \"Smith\",\n  \"state\": \"NSW\",\n  \"postcode\": \"2000\",\n  \"suburb\": \"Sydney\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/australia-aec-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  \"dob\": \"15-03-1990\",\n  \"familyName\": \"Smith\",\n  \"state\": \"NSW\",\n  \"postcode\": \"2000\",\n  \"suburb\": \"Sydney\"\n}"

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

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

POST

api

verifications

australia-aec-passthrough

AEC Electoral Roll

curl --request POST \
  --url https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/australia-aec-passthrough \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "dob": "15-03-1990",
  "familyName": "Smith",
  "state": "NSW",
  "postcode": "2000",
  "suburb": "Sydney"
}
'

import requests

url = "https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/australia-aec-passthrough"

payload = {
    "dob": "15-03-1990",
    "familyName": "Smith",
    "state": "NSW",
    "postcode": "2000",
    "suburb": "Sydney"
}
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({
    dob: '15-03-1990',
    familyName: 'Smith',
    state: 'NSW',
    postcode: '2000',
    suburb: 'Sydney'
  })
};

fetch('https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/australia-aec-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-aec-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([
    'dob' => '15-03-1990',
    'familyName' => 'Smith',
    'state' => 'NSW',
    'postcode' => '2000',
    'suburb' => 'Sydney'
  ]),
  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-aec-passthrough"

	payload := strings.NewReader("{\n  \"dob\": \"15-03-1990\",\n  \"familyName\": \"Smith\",\n  \"state\": \"NSW\",\n  \"postcode\": \"2000\",\n  \"suburb\": \"Sydney\"\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-aec-passthrough")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"dob\": \"15-03-1990\",\n  \"familyName\": \"Smith\",\n  \"state\": \"NSW\",\n  \"postcode\": \"2000\",\n  \"suburb\": \"Sydney\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/australia-aec-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  \"dob\": \"15-03-1990\",\n  \"familyName\": \"Smith\",\n  \"state\": \"NSW\",\n  \"postcode\": \"2000\",\n  \"suburb\": \"Sydney\"\n}"

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

{
  "success": true,
  "message": "Australia AEC Electoral Roll processed successfully",
  "data": {
    "isValid": true
  },
  "verificationStatus": "VERIFIED",
  "verificationStatusCode": 3,
  "transactionId": "79b6f81c-fc48-42ce-b907-763129b0957e",
  "verificationType": "australia_aec",
  "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

dob

string

required

Date of birth in DD-MM-YYYY format.

Example:

"15-03-1990"

familyName

string

required

Family name on the electoral roll.

state

string

required

State of enrolment.

Example:

"NSW"

postcode

string

required

Postcode of the enrolled address.

Example:

"2000"

suburb

string

required

Suburb of the enrolled address.

Example:

"Sydney"

givenName

string

Given name(s) on the electoral roll.

streetName

string

Street name of the enrolled address.

streetType

string

Street type of the enrolled address.

streetNumber

string

Street number of the enrolled address.

unitNumber

string

Unit number of the enrolled address, if any.

habitationName

string

Habitation name of the enrolled address, if any.

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

createdAt

string

required

metadata

object | null

API documentation

Australia DVS

AEC Electoral Roll

Authorizations

Headers

Body

Response