Skip to main content
POST
Driver License
Verify an Australian driver licence against the issuing state or territory road authority. Submit the licence number, the card number printed on the plastic, and the state of issue alongside the holder’s name and date of birth. The card number changes when a licence is reissued, so it must come from the physical card the holder currently has.

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

Driver License 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 on the licence.

givenName
string
required

Given name(s) on the licence.

dob
string
required

Date of birth in DD-MM-YYYY format.

Example:

"15-03-1990"

licenceNumber
string
required

Licence number.

stateOfIssue
string
required

State that issued the licence.

Example:

"NSW"

middleName
string

Middle name on the licence.

cardNumber
string

Card number printed on the licence.

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

createdAt
string
required
metadata
object | null