Validate with the AEC API

POST
/dvs/aec
LIVE

Validates a name, date of birth and address against the Australian Electoral Commission roll via the DVS. The AEC is one of the broadest identity datasets in the country, which makes this a good low-friction identity check for customers who don't want to hand over a document ID.

Example Request

POST
request.json
key Auth: BearerAuth
{
  "consent": true,
  "first_name": "John",
  "last_name": "Smith",
  "birth_date": "1980-01-01",
  "state": "VIC",
  "postcode": "3000",
  "suburb": "Melbourne",
  "street_address": "The Rialto 5/123 Smith St"
}

Request Schema

preflight
Optional
string

Validates the input shape without performing the check.

consent
Required
string

The individual's consent to perform the check.

first_name and last_name
Required
string

Name on the AEC roll.

birth_date
Required
string

YYYY-MM-DD.

state postcode suburb
Required
string

Address components.

street_address
Optional
string

Full street line. Don't combine this with the parsed parts below.

street_number street_name street_type flat_unit_number habitation_building_name
Optional
string

Parsed components as an alternative to street_address.

Available Response Data

5 Data Points
01
monitor_heart

verification_result_code: Y, N, D or S

02
data_object

activity_id for DVS-side log tracing

03
tag

verification_request_number

unique reference

04
mail

additional_information array on N or D responses, with reason codes and messages

for example EC-001 Address not known or invalid

05
fingerprint

API reference UUID

lock Full API documentation provided after vetting from our compliance team.
By The Numbers

API Data Scale & Coverage tag

Unmatched data depth to power your compliance and verification workflows.

50M+
Phone & Email Records
40M+
Adverse Court Records
2BN+
Australian Universe Records
18M+
Real Estate Records
7M+
Deceased Records
980M+
Social Media & Employment Records
Practical Applications

Technical Use Cases tag

verified

Identity verification without a document

When a customer would rather not upload a document, the AEC check gives you a strong identity signal using just name, DOB and address. Works well for Australian-born customers who have voted.

home

Address verification

Confirm an individual is enrolled at the address they've supplied. Good cross-check for proof-of-residency in financial services onboarding.

verified_user

Adding a second source for multi-source ID Verification

Pair it with a driver licence DVS check to satisfy a two-source identity requirement from two independent government datasets.

Trust & Assurance

Compliance & Security tag

Enterprise-grade infrastructure audited against the standards your regulators require.

verified_user
ISO 27001 Certified
enhanced_encryption
AES-256 Encryption
public
Australian Data Sovereignty
Integration & Support

Common Questions tag

Everything you need to know about implementation details and compliance infrastructure.

gavel Compliance

Does the AEC give back any personal information?

add

No. The DVS returns a yes/no result only. No personal information is disclosed. The response tells you whether the details you supplied match a record on the AEC roll, nothing more.

rocket_launch Implementation

What does a D result mean?

add

D means the document is invalid or not electronically captured. Treat it as a hard failure for verification. N means no match. S is an upstream DVS error and you should retry.

Try it Live

API Testing Sandbox tag

Test the Validate with the AEC API directly in your browser with live mock data and see instant results.

rocket_launch Request Sandbox Access

Access to live sandbox environments requires manual approval from our compliance team.

BACK TO TOP