API docs by Redocly

IDV API (AAMVA+) (1.0.0)

Download OpenAPI specification:Download

API Support: support@trusona.com URL: https://trusona.com

Base URL: https://authcloud.trusona.net

API for driver license verification against DMV and MNO databases.

ID Verifications

Initiate driver license verification against DMV and MNO databases

Starts an asynchronous verification process. Retrieve the results with GET /api/v1/id_verifications/{verificationId}. If a callbackUrl is provided, an identity_verification_changed event with the verification id is posted to it once all requested verifications complete.

Authorizations:
bearerAuth
Request Body schema: application/json
required
address1
string or null

A person's street address 1

address2
string or null

A person's street address 2

callbackUrl
string or null <uri>

URL where verification results will be sent upon completion

city
string or null

A name of a city or town.

dateOfBirth
required
string non-empty

A person's date of birth in the format of YYYY-MM-DD

firstName
string or null

A person's first name

lastName
string or null

A person's last name

middleName
string or null

A person's middle name

state
string or null^[A-Z]{2}$

A state, commonwealth, province, or other such geopolitical subdivision of a country.

suffix
string or null

A term appended after the family name that qualifies the name. (e.g. 'Jr')

transactionId
required
string <uuid>

A UUID to use for tracking this request. It must be unique for each request.

required
object (IdVerifiers)
zip4
string or null^\d{4}$

The ZIP+4 extension of the postal code.

zipCode
string or null^\d{5}$

An identifier of a post office-assigned zone for an address.

Responses

Request samples

Content type
application/json
{
  • "address1": "123 MAIN ST",
  • "address2": "APT 4B",
  • "callbackUrl": "https://example.com/webhooks/id-verification",
  • "city": "LOS ANGELES",
  • "dateOfBirth": "1985-03-22",
  • "firstName": "JOHN",
  • "lastName": "DOE",
  • "middleName": "MICHAEL",
  • "state": "CA",
  • "suffix": "JR",
  • "transactionId": "bd30618f-06d3-45c5-ae52-c36751fc20b2",
  • "verifiers": {
    },
  • "zip4": "1234",
  • "zipCode": "90210"
}

Response samples

Content type
*/*
{
  "createdAt": "2026-05-05T18:00:00Z",
  "id": "bd30618f-06d3-45c5-ae52-c36751fc20b2"
}

Get driver license verification results

Retrieve the results of a previously initiated verification request.

Authorizations:
bearerAuth
path Parameters
verificationId
required
string <uuid>

Responses

Response samples

Content type
*/*
{
  "completedAt": "2026-05-05T18:00:04Z",
  "createdAt": "2026-05-05T18:00:00Z",
  "dmvMatches": {
    "address1": true,
    "city": true,
    "dateOfBirth": true,
    "documentNumber": true,
    "expiryDate": true,
    "eyeColor": true,
    "firstName": true,
    "issueDate": true,
    "lastName": true,
    "middleName": true,
    "sex": true,
    "state": true,
    "zipCode": true
  },
  "dmvStatus": "SUCCESS",
  "id": "bd30618f-06d3-45c5-ae52-c36751fc20b2",
  "mnoMatches": {
    "address1": true,
    "city": true,
    "dateOfBirth": true,
    "firstName": true,
    "lastName": true,
    "phoneNumber": true,
    "phoneSim": true,
    "state": true,
    "zipCode": true
  },
  "mnoStatus": "SUCCESS"
}