Trusona ID Proofing Service Sandbox

This document describes example requests and responses that can be used for testing in Trusona’s ID Proofing Service Sandbox.

1. Using this document

The test cases listed below include common scenarios you will encounter when verifying ID documents with Trusona’s ID Proofing Service. Each test case describes the sample input sent by your system and the return values provided by Trusona. The data in these test cases is fake and does not represent a real identity. No requests are actually sent to the state for verification.

Use these examples when creating your solution to ensure that you’ve covered these common cases.

1.1. Accessing the Sandbox

API Credentials are required to access the sandbox. Trusona provides these credentials, if you have not yet received credentials, email support@trusona.com.

2. Test Cases

Test case Description
DL000001 All fields match exactly
DL000002 No fields match exactly
DL000003 Street address does not match
DL000004 City in address does not match
DL000005 State in address does not match
DL000006 ZIP-5 in address does not match
DL000007 ZIP-4 in address does not match
DL000008 Document category does not match
DL000009 Drivers license expiration date does not match
DL000010 Drivers license issue date does not match
DL000011 Eye color does not match
DL000012 Height does not match
DL000013 Weight does not match
DL000014 Sex does not match
DL000015 First w/ fuzzy match, not exact match
DL000016 Middle w/ fuzzy match, not exact match
DL000017 Last w/ fuzzy match, not exact match
DL000018 All name fields with fuzzy match, not exact match
DL000019 Middle initial matches, but middle name does not match
DL000020 Name suffix does not match
DL000021 DL number does not match
DL000022 Some fields could not be matched because the DMV/MVD/MVA does not have the data
DL000023 Very long first and last name (which are truncated) but all fields still match
DL000024 No middle name, all fields matching

2.1. Test case DL000001

All fields match exactly

2.1.1. Request parameters

Name Value
address_delivery_point_text_1 1515 Oak Street
address_delivery_point_text_2 APT 123
document_category_code 1
drivers_license_expiration_date 20300401
drivers_license_issue_date 20100401
identification_id DL000001
location_city_name Phoenix
location_postal_code 85000
location_state_us_postal_service_code AZ
message_destination_id AZ
person_birth_date 19700401
person_eye_color_code GRN
person_given_name John
person_height_measure 600
person_middle_name Quincy
person_name_suffix_text JR
person_sex_code 1
person_sur_name Doe
person_weight_measure 180

2.1.2. Response parameters

Name Value
address_city_match_indicator TRUE
address_line1_match_indicator TRUE
address_line2_match_indicator TRUE
address_state_code_match_indicator TRUE
address_zip4_match_indicator TRUE
address_zip5_match_indicator TRUE
document_category_match_indicator TRUE
drivers_license_expiration_date_match_indicator TRUE
drivers_license_issue_date_match_indicator TRUE
drivers_license_number_match_indicator TRUE
person_birth_date_match_indicator TRUE
person_eye_color_match_indicator TRUE
person_first_name_exact_match_indicator TRUE
person_first_name_fuzzy_alternate_match_indicator FALSE
person_first_name_fuzzy_primary_match_indicator FALSE
person_height_match_indicator TRUE
person_last_name_exact_match_indicator TRUE
person_last_name_fuzzy_alternate_match_indicator FALSE
person_last_name_fuzzy_primary_match_indicator FALSE
person_middle_initial_match_indicator TRUE
person_middle_name_exact_match_indicator TRUE
person_middle_name_fuzzy_alternate_match_indicator FALSE
person_middle_name_fuzzy_primary_match_indicator FALSE
person_name_suffix_match_indicator TRUE
person_sex_code_match_indicator TRUE
person_weight_match_indicator TRUE
replay NULL
transaction_locator_id UUID

2.1.3. Example cURL request

curl -X "POST" "https://idproof-cert.trusona.net/api/v2/verifications" \
     -H 'Content-Type: application/json' \
     -H 'Authorization: Bearer <YOUR API TOKEN>' \
     -d $'{
            "aamva": {
              "address_delivery_point_text_1": "1515 Oak Street",
              "address_delivery_point_text_2": "APT 123",
              "document_category_code": "1",
              "drivers_license_expiration_date": "20300401",
              "drivers_license_issue_date": "20100401",
              "identification_id": "DL000001",
              "location_city_name": "Phoenix",
              "location_postal_code": "85000",
              "location_state_us_postal_service_code": "AZ",
              "message_destination_id": "AZ",
              "person_birth_date": "19700401",
              "person_eye_color_code": "GRN",
              "person_given_name": "John",
              "person_height_measure": "600",
              "person_middle_name": "Quincy",
              "person_name_suffix_text": "JR",
              "person_sex_code": "1",
              "person_sur_name": "Doe",
              "person_weight_measure": "180"
            }
          }'

2.2. Test case DL000002

No fields match exactly

2.2.1. Request parameters

Name Value
address_delivery_point_text_1 1515 Oak Street
address_delivery_point_text_2 APT 123
document_category_code 1
drivers_license_expiration_date 20300401
drivers_license_issue_date 20100401
identification_id DL000002
location_city_name Phoenix
location_postal_code 85000
location_state_us_postal_service_code AZ
message_destination_id AZ
person_birth_date 19700401
person_eye_color_code GRN
person_given_name John
person_height_measure 600
person_middle_name Quincy
person_name_suffix_text JR
person_sex_code 1
person_sur_name Doe
person_weight_measure 180

2.2.2. Response parameters

Name Value
address_city_match_indicator FALSE
address_line1_match_indicator FALSE
address_line2_match_indicator FALSE
address_state_code_match_indicator FALSE
address_zip4_match_indicator FALSE
address_zip5_match_indicator FALSE
document_category_match_indicator FALSE
drivers_license_expiration_date_match_indicator FALSE
drivers_license_issue_date_match_indicator FALSE
drivers_license_number_match_indicator FALSE
person_birth_date_match_indicator FALSE
person_eye_color_match_indicator FALSE
person_first_name_exact_match_indicator FALSE
person_first_name_fuzzy_alternate_match_indicator FALSE
person_first_name_fuzzy_primary_match_indicator FALSE
person_height_match_indicator FALSE
person_last_name_exact_match_indicator FALSE
person_last_name_fuzzy_alternate_match_indicator FALSE
person_last_name_fuzzy_primary_match_indicator FALSE
person_middle_initial_match_indicator FALSE
person_middle_name_exact_match_indicator FALSE
person_middle_name_fuzzy_alternate_match_indicator FALSE
person_middle_name_fuzzy_primary_match_indicator FALSE
person_name_suffix_match_indicator FALSE
person_sex_code_match_indicator FALSE
person_weight_match_indicator FALSE
replay NULL
transaction_locator_id UUID

2.2.3. Example cURL request

curl -X "POST" "https://idproof-cert.trusona.net/api/v2/verifications" \
     -H 'Content-Type: application/json' \
     -H 'Authorization: Bearer <YOUR API TOKEN>' \
     -d $'{
            "aamva": {
              "address_delivery_point_text_1": "1515 Oak Street",
              "address_delivery_point_text_2": "APT 123",
              "document_category_code": "1",
              "drivers_license_expiration_date": "20300401",
              "drivers_license_issue_date": "20100401",
              "identification_id": "DL000002",
              "location_city_name": "Phoenix",
              "location_postal_code": "85000",
              "location_state_us_postal_service_code": "AZ",
              "message_destination_id": "AZ",
              "person_birth_date": "19700401",
              "person_eye_color_code": "GRN",
              "person_given_name": "John",
              "person_height_measure": "600",
              "person_middle_name": "Quincy",
              "person_name_suffix_text": "JR",
              "person_sex_code": "1",
              "person_sur_name": "Doe",
              "person_weight_measure": "180"
            }
          }'

2.3. Test case DL000003

Street address does not match

2.3.1. Request parameters

Name Value
address_delivery_point_text_1 1515 Oak Street
address_delivery_point_text_2 APT 123
document_category_code 1
drivers_license_expiration_date 20300401
drivers_license_issue_date 20100401
identification_id DL000003
location_city_name Phoenix
location_postal_code 85000
location_state_us_postal_service_code AZ
message_destination_id AZ
person_birth_date 19700401
person_eye_color_code GRN
person_given_name John
person_height_measure 600
person_middle_name Quincy
person_name_suffix_text JR
person_sex_code 1
person_sur_name Doe
person_weight_measure 180

2.3.2. Response parameters

Name Value
address_city_match_indicator TRUE
address_line1_match_indicator FALSE
address_line2_match_indicator FALSE
address_state_code_match_indicator TRUE
address_zip4_match_indicator TRUE
address_zip5_match_indicator TRUE
document_category_match_indicator TRUE
drivers_license_expiration_date_match_indicator TRUE
drivers_license_issue_date_match_indicator TRUE
drivers_license_number_match_indicator TRUE
person_birth_date_match_indicator TRUE
person_eye_color_match_indicator TRUE
person_first_name_exact_match_indicator TRUE
person_first_name_fuzzy_alternate_match_indicator FALSE
person_first_name_fuzzy_primary_match_indicator FALSE
person_height_match_indicator TRUE
person_last_name_exact_match_indicator TRUE
person_last_name_fuzzy_alternate_match_indicator FALSE
person_last_name_fuzzy_primary_match_indicator FALSE
person_middle_initial_match_indicator TRUE
person_middle_name_exact_match_indicator TRUE
person_middle_name_fuzzy_alternate_match_indicator FALSE
person_middle_name_fuzzy_primary_match_indicator FALSE
person_name_suffix_match_indicator TRUE
person_sex_code_match_indicator TRUE
person_weight_match_indicator TRUE
replay NULL
transaction_locator_id UUID

2.3.3. Example cURL request

curl -X "POST" "https://idproof-cert.trusona.net/api/v2/verifications" \
     -H 'Content-Type: application/json' \
     -H 'Authorization: Bearer <YOUR API TOKEN>' \
     -d $'{
            "aamva": {
              "address_delivery_point_text_1": "1515 Oak Street",
              "address_delivery_point_text_2": "APT 123",
              "document_category_code": "1",
              "drivers_license_expiration_date": "20300401",
              "drivers_license_issue_date": "20100401",
              "identification_id": "DL000003",
              "location_city_name": "Phoenix",
              "location_postal_code": "85000",
              "location_state_us_postal_service_code": "AZ",
              "message_destination_id": "AZ",
              "person_birth_date": "19700401",
              "person_eye_color_code": "GRN",
              "person_given_name": "John",
              "person_height_measure": "600",
              "person_middle_name": "Quincy",
              "person_name_suffix_text": "JR",
              "person_sex_code": "1",
              "person_sur_name": "Doe",
              "person_weight_measure": "180"
            }
          }'

2.4. Test case DL000004

City in address does not match

2.4.1. Request parameters

Name Value
address_delivery_point_text_1 1515 Oak Street
address_delivery_point_text_2 APT 123
document_category_code 1
drivers_license_expiration_date 20300401
drivers_license_issue_date 20100401
identification_id DL000004
location_city_name Phoenix
location_postal_code 85000
location_state_us_postal_service_code AZ
message_destination_id AZ
person_birth_date 19700401
person_eye_color_code GRN
person_given_name John
person_height_measure 600
person_middle_name Quincy
person_name_suffix_text JR
person_sex_code 1
person_sur_name Doe
person_weight_measure 180

2.4.2. Response parameters

Name Value
address_city_match_indicator FALSE
address_line1_match_indicator TRUE
address_line2_match_indicator TRUE
address_state_code_match_indicator TRUE
address_zip4_match_indicator TRUE
address_zip5_match_indicator TRUE
document_category_match_indicator TRUE
drivers_license_expiration_date_match_indicator TRUE
drivers_license_issue_date_match_indicator TRUE
drivers_license_number_match_indicator TRUE
person_birth_date_match_indicator TRUE
person_eye_color_match_indicator TRUE
person_first_name_exact_match_indicator TRUE
person_first_name_fuzzy_alternate_match_indicator FALSE
person_first_name_fuzzy_primary_match_indicator FALSE
person_height_match_indicator TRUE
person_last_name_exact_match_indicator TRUE
person_last_name_fuzzy_alternate_match_indicator FALSE
person_last_name_fuzzy_primary_match_indicator FALSE
person_middle_initial_match_indicator TRUE
person_middle_name_exact_match_indicator TRUE
person_middle_name_fuzzy_alternate_match_indicator FALSE
person_middle_name_fuzzy_primary_match_indicator FALSE
person_name_suffix_match_indicator TRUE
person_sex_code_match_indicator TRUE
person_weight_match_indicator TRUE
replay NULL
transaction_locator_id UUID

2.4.3. Example cURL request

curl -X "POST" "https://idproof-cert.trusona.net/api/v2/verifications" \
     -H 'Content-Type: application/json' \
     -H 'Authorization: Bearer <YOUR API TOKEN>' \
     -d $'{
            "aamva": {
              "address_delivery_point_text_1": "1515 Oak Street",
              "address_delivery_point_text_2": "APT 123",
              "document_category_code": "1",
              "drivers_license_expiration_date": "20300401",
              "drivers_license_issue_date": "20100401",
              "identification_id": "DL000004",
              "location_city_name": "Phoenix",
              "location_postal_code": "85000",
              "location_state_us_postal_service_code": "AZ",
              "message_destination_id": "AZ",
              "person_birth_date": "19700401",
              "person_eye_color_code": "GRN",
              "person_given_name": "John",
              "person_height_measure": "600",
              "person_middle_name": "Quincy",
              "person_name_suffix_text": "JR",
              "person_sex_code": "1",
              "person_sur_name": "Doe",
              "person_weight_measure": "180"
            }
          }'

2.5. Test case DL000005

State in address does not match

2.5.1. Request parameters

Name Value
address_delivery_point_text_1 1515 Oak Street
address_delivery_point_text_2 APT 123
document_category_code 1
drivers_license_expiration_date 20300401
drivers_license_issue_date 20100401
identification_id DL000005
location_city_name Phoenix
location_postal_code 85000
location_state_us_postal_service_code AZ
message_destination_id AZ
person_birth_date 19700401
person_eye_color_code GRN
person_given_name John
person_height_measure 600
person_middle_name Quincy
person_name_suffix_text JR
person_sex_code 1
person_sur_name Doe
person_weight_measure 180

2.5.2. Response parameters

Name Value
address_city_match_indicator TRUE
address_line1_match_indicator TRUE
address_line2_match_indicator TRUE
address_state_code_match_indicator FALSE
address_zip4_match_indicator TRUE
address_zip5_match_indicator TRUE
document_category_match_indicator TRUE
drivers_license_expiration_date_match_indicator TRUE
drivers_license_issue_date_match_indicator TRUE
drivers_license_number_match_indicator TRUE
person_birth_date_match_indicator TRUE
person_eye_color_match_indicator TRUE
person_first_name_exact_match_indicator TRUE
person_first_name_fuzzy_alternate_match_indicator FALSE
person_first_name_fuzzy_primary_match_indicator FALSE
person_height_match_indicator TRUE
person_last_name_exact_match_indicator TRUE
person_last_name_fuzzy_alternate_match_indicator FALSE
person_last_name_fuzzy_primary_match_indicator FALSE
person_middle_initial_match_indicator TRUE
person_middle_name_exact_match_indicator TRUE
person_middle_name_fuzzy_alternate_match_indicator FALSE
person_middle_name_fuzzy_primary_match_indicator FALSE
person_name_suffix_match_indicator TRUE
person_sex_code_match_indicator TRUE
person_weight_match_indicator TRUE
replay NULL
transaction_locator_id UUID

2.5.3. Example cURL request

curl -X "POST" "https://idproof-cert.trusona.net/api/v2/verifications" \
     -H 'Content-Type: application/json' \
     -H 'Authorization: Bearer <YOUR API TOKEN>' \
     -d $'{
            "aamva": {
              "address_delivery_point_text_1": "1515 Oak Street",
              "address_delivery_point_text_2": "APT 123",
              "document_category_code": "1",
              "drivers_license_expiration_date": "20300401",
              "drivers_license_issue_date": "20100401",
              "identification_id": "DL000005",
              "location_city_name": "Phoenix",
              "location_postal_code": "85000",
              "location_state_us_postal_service_code": "AZ",
              "message_destination_id": "AZ",
              "person_birth_date": "19700401",
              "person_eye_color_code": "GRN",
              "person_given_name": "John",
              "person_height_measure": "600",
              "person_middle_name": "Quincy",
              "person_name_suffix_text": "JR",
              "person_sex_code": "1",
              "person_sur_name": "Doe",
              "person_weight_measure": "180"
            }
          }'

2.6. Test case DL000006

ZIP-5 in address does not match

2.6.1. Request parameters

Name Value
address_delivery_point_text_1 1515 Oak Street
address_delivery_point_text_2 APT 123
document_category_code 1
drivers_license_expiration_date 20300401
drivers_license_issue_date 20100401
identification_id DL000006
location_city_name Phoenix
location_postal_code 85000
location_state_us_postal_service_code AZ
message_destination_id AZ
person_birth_date 19700401
person_eye_color_code GRN
person_given_name John
person_height_measure 600
person_middle_name Quincy
person_name_suffix_text JR
person_sex_code 1
person_sur_name Doe
person_weight_measure 180

2.6.2. Response parameters

Name Value
address_city_match_indicator TRUE
address_line1_match_indicator TRUE
address_line2_match_indicator TRUE
address_state_code_match_indicator TRUE
address_zip4_match_indicator TRUE
address_zip5_match_indicator FALSE
document_category_match_indicator TRUE
drivers_license_expiration_date_match_indicator TRUE
drivers_license_issue_date_match_indicator TRUE
drivers_license_number_match_indicator TRUE
person_birth_date_match_indicator TRUE
person_eye_color_match_indicator TRUE
person_first_name_exact_match_indicator TRUE
person_first_name_fuzzy_alternate_match_indicator FALSE
person_first_name_fuzzy_primary_match_indicator FALSE
person_height_match_indicator TRUE
person_last_name_exact_match_indicator TRUE
person_last_name_fuzzy_alternate_match_indicator FALSE
person_last_name_fuzzy_primary_match_indicator FALSE
person_middle_initial_match_indicator TRUE
person_middle_name_exact_match_indicator TRUE
person_middle_name_fuzzy_alternate_match_indicator FALSE
person_middle_name_fuzzy_primary_match_indicator FALSE
person_name_suffix_match_indicator TRUE
person_sex_code_match_indicator TRUE
person_weight_match_indicator TRUE
replay NULL
transaction_locator_id UUID

2.6.3. Example cURL request

curl -X "POST" "https://idproof-cert.trusona.net/api/v2/verifications" \
     -H 'Content-Type: application/json' \
     -H 'Authorization: Bearer <YOUR API TOKEN>' \
     -d $'{
            "aamva": {
              "address_delivery_point_text_1": "1515 Oak Street",
              "address_delivery_point_text_2": "APT 123",
              "document_category_code": "1",
              "drivers_license_expiration_date": "20300401",
              "drivers_license_issue_date": "20100401",
              "identification_id": "DL000006",
              "location_city_name": "Phoenix",
              "location_postal_code": "85000",
              "location_state_us_postal_service_code": "AZ",
              "message_destination_id": "AZ",
              "person_birth_date": "19700401",
              "person_eye_color_code": "GRN",
              "person_given_name": "John",
              "person_height_measure": "600",
              "person_middle_name": "Quincy",
              "person_name_suffix_text": "JR",
              "person_sex_code": "1",
              "person_sur_name": "Doe",
              "person_weight_measure": "180"
            }
          }'

2.7. Test case DL000007

ZIP-4 in address does not match

2.7.1. Request parameters

Name Value
address_delivery_point_text_1 1515 Oak Street
address_delivery_point_text_2 APT 123
document_category_code 1
drivers_license_expiration_date 20300401
drivers_license_issue_date 20100401
identification_id DL000007
location_city_name Phoenix
location_postal_code 85000
location_state_us_postal_service_code AZ
message_destination_id AZ
person_birth_date 19700401
person_eye_color_code GRN
person_given_name John
person_height_measure 600
person_middle_name Quincy
person_name_suffix_text JR
person_sex_code 1
person_sur_name Doe
person_weight_measure 180

2.7.2. Response parameters

Name Value
address_city_match_indicator TRUE
address_line1_match_indicator TRUE
address_line2_match_indicator TRUE
address_state_code_match_indicator TRUE
address_zip4_match_indicator FALSE
address_zip5_match_indicator TRUE
document_category_match_indicator TRUE
drivers_license_expiration_date_match_indicator TRUE
drivers_license_issue_date_match_indicator TRUE
drivers_license_number_match_indicator TRUE
person_birth_date_match_indicator TRUE
person_eye_color_match_indicator TRUE
person_first_name_exact_match_indicator TRUE
person_first_name_fuzzy_alternate_match_indicator FALSE
person_first_name_fuzzy_primary_match_indicator FALSE
person_height_match_indicator TRUE
person_last_name_exact_match_indicator TRUE
person_last_name_fuzzy_alternate_match_indicator FALSE
person_last_name_fuzzy_primary_match_indicator FALSE
person_middle_initial_match_indicator TRUE
person_middle_name_exact_match_indicator TRUE
person_middle_name_fuzzy_alternate_match_indicator FALSE
person_middle_name_fuzzy_primary_match_indicator FALSE
person_name_suffix_match_indicator TRUE
person_sex_code_match_indicator TRUE
person_weight_match_indicator TRUE
replay NULL
transaction_locator_id UUID

2.7.3. Example cURL request

curl -X "POST" "https://idproof-cert.trusona.net/api/v2/verifications" \
     -H 'Content-Type: application/json' \
     -H 'Authorization: Bearer <YOUR API TOKEN>' \
     -d $'{
            "aamva": {
              "address_delivery_point_text_1": "1515 Oak Street",
              "address_delivery_point_text_2": "APT 123",
              "document_category_code": "1",
              "drivers_license_expiration_date": "20300401",
              "drivers_license_issue_date": "20100401",
              "identification_id": "DL000007",
              "location_city_name": "Phoenix",
              "location_postal_code": "85000",
              "location_state_us_postal_service_code": "AZ",
              "message_destination_id": "AZ",
              "person_birth_date": "19700401",
              "person_eye_color_code": "GRN",
              "person_given_name": "John",
              "person_height_measure": "600",
              "person_middle_name": "Quincy",
              "person_name_suffix_text": "JR",
              "person_sex_code": "1",
              "person_sur_name": "Doe",
              "person_weight_measure": "180"
            }
          }'

2.8. Test case DL000008

Document category does not match

2.8.1. Request parameters

Name Value
address_delivery_point_text_1 1515 Oak Street
address_delivery_point_text_2 APT 123
document_category_code 1
drivers_license_expiration_date 20300401
drivers_license_issue_date 20100401
identification_id DL000008
location_city_name Phoenix
location_postal_code 85000
location_state_us_postal_service_code AZ
message_destination_id AZ
person_birth_date 19700401
person_eye_color_code GRN
person_given_name John
person_height_measure 600
person_middle_name Quincy
person_name_suffix_text JR
person_sex_code 1
person_sur_name Doe
person_weight_measure 180

2.8.2. Response parameters

Name Value
address_city_match_indicator TRUE
address_line1_match_indicator TRUE
address_line2_match_indicator TRUE
address_state_code_match_indicator TRUE
address_zip4_match_indicator TRUE
address_zip5_match_indicator TRUE
document_category_match_indicator FALSE
drivers_license_expiration_date_match_indicator TRUE
drivers_license_issue_date_match_indicator TRUE
drivers_license_number_match_indicator TRUE
person_birth_date_match_indicator TRUE
person_eye_color_match_indicator TRUE
person_first_name_exact_match_indicator TRUE
person_first_name_fuzzy_alternate_match_indicator FALSE
person_first_name_fuzzy_primary_match_indicator FALSE
person_height_match_indicator TRUE
person_last_name_exact_match_indicator TRUE
person_last_name_fuzzy_alternate_match_indicator FALSE
person_last_name_fuzzy_primary_match_indicator FALSE
person_middle_initial_match_indicator TRUE
person_middle_name_exact_match_indicator TRUE
person_middle_name_fuzzy_alternate_match_indicator FALSE
person_middle_name_fuzzy_primary_match_indicator FALSE
person_name_suffix_match_indicator TRUE
person_sex_code_match_indicator TRUE
person_weight_match_indicator TRUE
replay NULL
transaction_locator_id UUID

2.8.3. Example cURL request

curl -X "POST" "https://idproof-cert.trusona.net/api/v2/verifications" \
     -H 'Content-Type: application/json' \
     -H 'Authorization: Bearer <YOUR API TOKEN>' \
     -d $'{
            "aamva": {
              "address_delivery_point_text_1": "1515 Oak Street",
              "address_delivery_point_text_2": "APT 123",
              "document_category_code": "1",
              "drivers_license_expiration_date": "20300401",
              "drivers_license_issue_date": "20100401",
              "identification_id": "DL000008",
              "location_city_name": "Phoenix",
              "location_postal_code": "85000",
              "location_state_us_postal_service_code": "AZ",
              "message_destination_id": "AZ",
              "person_birth_date": "19700401",
              "person_eye_color_code": "GRN",
              "person_given_name": "John",
              "person_height_measure": "600",
              "person_middle_name": "Quincy",
              "person_name_suffix_text": "JR",
              "person_sex_code": "1",
              "person_sur_name": "Doe",
              "person_weight_measure": "180"
            }
          }'

2.9. Test case DL000009

Drivers license expiration date does not match

2.9.1. Request parameters

Name Value
address_delivery_point_text_1 1515 Oak Street
address_delivery_point_text_2 APT 123
document_category_code 1
drivers_license_expiration_date 20300401
drivers_license_issue_date 20100401
identification_id DL000009
location_city_name Phoenix
location_postal_code 85000
location_state_us_postal_service_code AZ
message_destination_id AZ
person_birth_date 19700401
person_eye_color_code GRN
person_given_name John
person_height_measure 600
person_middle_name Quincy
person_name_suffix_text JR
person_sex_code 1
person_sur_name Doe
person_weight_measure 180

2.9.2. Response parameters

Name Value
address_city_match_indicator TRUE
address_line1_match_indicator TRUE
address_line2_match_indicator TRUE
address_state_code_match_indicator TRUE
address_zip4_match_indicator TRUE
address_zip5_match_indicator TRUE
document_category_match_indicator TRUE
drivers_license_expiration_date_match_indicator TRUE
drivers_license_issue_date_match_indicator TRUE
drivers_license_number_match_indicator TRUE
person_birth_date_match_indicator TRUE
person_eye_color_match_indicator TRUE
person_first_name_exact_match_indicator TRUE
person_first_name_fuzzy_alternate_match_indicator FALSE
person_first_name_fuzzy_primary_match_indicator FALSE
person_height_match_indicator TRUE
person_last_name_exact_match_indicator TRUE
person_last_name_fuzzy_alternate_match_indicator FALSE
person_last_name_fuzzy_primary_match_indicator FALSE
person_middle_initial_match_indicator TRUE
person_middle_name_exact_match_indicator TRUE
person_middle_name_fuzzy_alternate_match_indicator FALSE
person_middle_name_fuzzy_primary_match_indicator FALSE
person_name_suffix_match_indicator TRUE
person_sex_code_match_indicator TRUE
person_weight_match_indicator TRUE
replay NULL
transaction_locator_id UUID

2.9.3. Example cURL request

curl -X "POST" "https://idproof-cert.trusona.net/api/v2/verifications" \
     -H 'Content-Type: application/json' \
     -H 'Authorization: Bearer <YOUR API TOKEN>' \
     -d $'{
            "aamva": {
              "address_delivery_point_text_1": "1515 Oak Street",
              "address_delivery_point_text_2": "APT 123",
              "document_category_code": "1",
              "drivers_license_expiration_date": "20300401",
              "drivers_license_issue_date": "20100401",
              "identification_id": "DL000009",
              "location_city_name": "Phoenix",
              "location_postal_code": "85000",
              "location_state_us_postal_service_code": "AZ",
              "message_destination_id": "AZ",
              "person_birth_date": "19700401",
              "person_eye_color_code": "GRN",
              "person_given_name": "John",
              "person_height_measure": "600",
              "person_middle_name": "Quincy",
              "person_name_suffix_text": "JR",
              "person_sex_code": "1",
              "person_sur_name": "Doe",
              "person_weight_measure": "180"
            }
          }'

2.10. Test case DL000010

Drivers license issue date does not match

2.10.1. Request parameters

Name Value
address_delivery_point_text_1 1515 Oak Street
address_delivery_point_text_2 APT 123
document_category_code 1
drivers_license_expiration_date 20300401
drivers_license_issue_date 20100401
identification_id DL000010
location_city_name Phoenix
location_postal_code 85000
location_state_us_postal_service_code AZ
message_destination_id AZ
person_birth_date 19700401
person_eye_color_code GRN
person_given_name John
person_height_measure 600
person_middle_name Quincy
person_name_suffix_text JR
person_sex_code 1
person_sur_name Doe
person_weight_measure 180

2.10.2. Response parameters

Name Value
address_city_match_indicator TRUE
address_line1_match_indicator TRUE
address_line2_match_indicator TRUE
address_state_code_match_indicator TRUE
address_zip4_match_indicator TRUE
address_zip5_match_indicator TRUE
document_category_match_indicator TRUE
drivers_license_expiration_date_match_indicator TRUE
drivers_license_issue_date_match_indicator FALSE
drivers_license_number_match_indicator TRUE
person_birth_date_match_indicator TRUE
person_eye_color_match_indicator TRUE
person_first_name_exact_match_indicator TRUE
person_first_name_fuzzy_alternate_match_indicator FALSE
person_first_name_fuzzy_primary_match_indicator FALSE
person_height_match_indicator TRUE
person_last_name_exact_match_indicator TRUE
person_last_name_fuzzy_alternate_match_indicator FALSE
person_last_name_fuzzy_primary_match_indicator FALSE
person_middle_initial_match_indicator TRUE
person_middle_name_exact_match_indicator TRUE
person_middle_name_fuzzy_alternate_match_indicator FALSE
person_middle_name_fuzzy_primary_match_indicator FALSE
person_name_suffix_match_indicator TRUE
person_sex_code_match_indicator TRUE
person_weight_match_indicator TRUE
replay NULL
transaction_locator_id UUID

2.10.3. Example cURL request

curl -X "POST" "https://idproof-cert.trusona.net/api/v2/verifications" \
     -H 'Content-Type: application/json' \
     -H 'Authorization: Bearer <YOUR API TOKEN>' \
     -d $'{
            "aamva": {
              "address_delivery_point_text_1": "1515 Oak Street",
              "address_delivery_point_text_2": "APT 123",
              "document_category_code": "1",
              "drivers_license_expiration_date": "20300401",
              "drivers_license_issue_date": "20100401",
              "identification_id": "DL000010",
              "location_city_name": "Phoenix",
              "location_postal_code": "85000",
              "location_state_us_postal_service_code": "AZ",
              "message_destination_id": "AZ",
              "person_birth_date": "19700401",
              "person_eye_color_code": "GRN",
              "person_given_name": "John",
              "person_height_measure": "600",
              "person_middle_name": "Quincy",
              "person_name_suffix_text": "JR",
              "person_sex_code": "1",
              "person_sur_name": "Doe",
              "person_weight_measure": "180"
            }
          }'

2.11. Test case DL000011

Eye color does not match

2.11.1. Request parameters

Name Value
address_delivery_point_text_1 1515 Oak Street
address_delivery_point_text_2 APT 123
document_category_code 1
drivers_license_expiration_date 20300401
drivers_license_issue_date 20100401
identification_id DL000011
location_city_name Phoenix
location_postal_code 85000
location_state_us_postal_service_code AZ
message_destination_id AZ
person_birth_date 19700401
person_eye_color_code GRN
person_given_name John
person_height_measure 600
person_middle_name Quincy
person_name_suffix_text JR
person_sex_code 1
person_sur_name Doe
person_weight_measure 180

2.11.2. Response parameters

Name Value
address_city_match_indicator TRUE
address_line1_match_indicator TRUE
address_line2_match_indicator TRUE
address_state_code_match_indicator TRUE
address_zip4_match_indicator TRUE
address_zip5_match_indicator TRUE
document_category_match_indicator TRUE
drivers_license_expiration_date_match_indicator TRUE
drivers_license_issue_date_match_indicator TRUE
drivers_license_number_match_indicator TRUE
person_birth_date_match_indicator TRUE
person_eye_color_match_indicator FALSE
person_first_name_exact_match_indicator TRUE
person_first_name_fuzzy_alternate_match_indicator FALSE
person_first_name_fuzzy_primary_match_indicator FALSE
person_height_match_indicator TRUE
person_last_name_exact_match_indicator TRUE
person_last_name_fuzzy_alternate_match_indicator FALSE
person_last_name_fuzzy_primary_match_indicator FALSE
person_middle_initial_match_indicator TRUE
person_middle_name_exact_match_indicator TRUE
person_middle_name_fuzzy_alternate_match_indicator FALSE
person_middle_name_fuzzy_primary_match_indicator FALSE
person_name_suffix_match_indicator TRUE
person_sex_code_match_indicator TRUE
person_weight_match_indicator TRUE
replay NULL
transaction_locator_id UUID

2.11.3. Example cURL request

curl -X "POST" "https://idproof-cert.trusona.net/api/v2/verifications" \
     -H 'Content-Type: application/json' \
     -H 'Authorization: Bearer <YOUR API TOKEN>' \
     -d $'{
            "aamva": {
              "address_delivery_point_text_1": "1515 Oak Street",
              "address_delivery_point_text_2": "APT 123",
              "document_category_code": "1",
              "drivers_license_expiration_date": "20300401",
              "drivers_license_issue_date": "20100401",
              "identification_id": "DL000011",
              "location_city_name": "Phoenix",
              "location_postal_code": "85000",
              "location_state_us_postal_service_code": "AZ",
              "message_destination_id": "AZ",
              "person_birth_date": "19700401",
              "person_eye_color_code": "GRN",
              "person_given_name": "John",
              "person_height_measure": "600",
              "person_middle_name": "Quincy",
              "person_name_suffix_text": "JR",
              "person_sex_code": "1",
              "person_sur_name": "Doe",
              "person_weight_measure": "180"
            }
          }'

2.12. Test case DL000012

Height does not match

2.12.1. Request parameters

Name Value
address_delivery_point_text_1 1515 Oak Street
address_delivery_point_text_2 APT 123
document_category_code 1
drivers_license_expiration_date 20300401
drivers_license_issue_date 20100401
identification_id DL000012
location_city_name Phoenix
location_postal_code 85000
location_state_us_postal_service_code AZ
message_destination_id AZ
person_birth_date 19700401
person_eye_color_code GRN
person_given_name John
person_height_measure 600
person_middle_name Quincy
person_name_suffix_text JR
person_sex_code 1
person_sur_name Doe
person_weight_measure 180

2.12.2. Response parameters

Name Value
address_city_match_indicator TRUE
address_line1_match_indicator TRUE
address_line2_match_indicator TRUE
address_state_code_match_indicator TRUE
address_zip4_match_indicator TRUE
address_zip5_match_indicator TRUE
document_category_match_indicator TRUE
drivers_license_expiration_date_match_indicator TRUE
drivers_license_issue_date_match_indicator TRUE
drivers_license_number_match_indicator TRUE
person_birth_date_match_indicator TRUE
person_eye_color_match_indicator TRUE
person_first_name_exact_match_indicator TRUE
person_first_name_fuzzy_alternate_match_indicator FALSE
person_first_name_fuzzy_primary_match_indicator FALSE
person_height_match_indicator FALSE
person_last_name_exact_match_indicator TRUE
person_last_name_fuzzy_alternate_match_indicator FALSE
person_last_name_fuzzy_primary_match_indicator FALSE
person_middle_initial_match_indicator TRUE
person_middle_name_exact_match_indicator TRUE
person_middle_name_fuzzy_alternate_match_indicator FALSE
person_middle_name_fuzzy_primary_match_indicator FALSE
person_name_suffix_match_indicator TRUE
person_sex_code_match_indicator TRUE
person_weight_match_indicator TRUE
replay NULL
transaction_locator_id UUID

2.12.3. Example cURL request

curl -X "POST" "https://idproof-cert.trusona.net/api/v2/verifications" \
     -H 'Content-Type: application/json' \
     -H 'Authorization: Bearer <YOUR API TOKEN>' \
     -d $'{
            "aamva": {
              "address_delivery_point_text_1": "1515 Oak Street",
              "address_delivery_point_text_2": "APT 123",
              "document_category_code": "1",
              "drivers_license_expiration_date": "20300401",
              "drivers_license_issue_date": "20100401",
              "identification_id": "DL000012",
              "location_city_name": "Phoenix",
              "location_postal_code": "85000",
              "location_state_us_postal_service_code": "AZ",
              "message_destination_id": "AZ",
              "person_birth_date": "19700401",
              "person_eye_color_code": "GRN",
              "person_given_name": "John",
              "person_height_measure": "600",
              "person_middle_name": "Quincy",
              "person_name_suffix_text": "JR",
              "person_sex_code": "1",
              "person_sur_name": "Doe",
              "person_weight_measure": "180"
            }
          }'

2.13. Test case DL000013

Weight does not match

2.13.1. Request parameters

Name Value
address_delivery_point_text_1 1515 Oak Street
address_delivery_point_text_2 APT 123
document_category_code 1
drivers_license_expiration_date 20300401
drivers_license_issue_date 20100401
identification_id DL000013
location_city_name Phoenix
location_postal_code 85000
location_state_us_postal_service_code AZ
message_destination_id AZ
person_birth_date 19700401
person_eye_color_code GRN
person_given_name John
person_height_measure 600
person_middle_name Quincy
person_name_suffix_text JR
person_sex_code 1
person_sur_name Doe
person_weight_measure 180

2.13.2. Response parameters

Name Value
address_city_match_indicator TRUE
address_line1_match_indicator TRUE
address_line2_match_indicator TRUE
address_state_code_match_indicator TRUE
address_zip4_match_indicator TRUE
address_zip5_match_indicator TRUE
document_category_match_indicator TRUE
drivers_license_expiration_date_match_indicator TRUE
drivers_license_issue_date_match_indicator TRUE
drivers_license_number_match_indicator TRUE
person_birth_date_match_indicator TRUE
person_eye_color_match_indicator TRUE
person_first_name_exact_match_indicator TRUE
person_first_name_fuzzy_alternate_match_indicator FALSE
person_first_name_fuzzy_primary_match_indicator FALSE
person_height_match_indicator TRUE
person_last_name_exact_match_indicator TRUE
person_last_name_fuzzy_alternate_match_indicator FALSE
person_last_name_fuzzy_primary_match_indicator FALSE
person_middle_initial_match_indicator TRUE
person_middle_name_exact_match_indicator TRUE
person_middle_name_fuzzy_alternate_match_indicator FALSE
person_middle_name_fuzzy_primary_match_indicator FALSE
person_name_suffix_match_indicator TRUE
person_sex_code_match_indicator TRUE
person_weight_match_indicator FALSE
replay NULL
transaction_locator_id UUID

2.13.3. Example cURL request

curl -X "POST" "https://idproof-cert.trusona.net/api/v2/verifications" \
     -H 'Content-Type: application/json' \
     -H 'Authorization: Bearer <YOUR API TOKEN>' \
     -d $'{
            "aamva": {
              "address_delivery_point_text_1": "1515 Oak Street",
              "address_delivery_point_text_2": "APT 123",
              "document_category_code": "1",
              "drivers_license_expiration_date": "20300401",
              "drivers_license_issue_date": "20100401",
              "identification_id": "DL000013",
              "location_city_name": "Phoenix",
              "location_postal_code": "85000",
              "location_state_us_postal_service_code": "AZ",
              "message_destination_id": "AZ",
              "person_birth_date": "19700401",
              "person_eye_color_code": "GRN",
              "person_given_name": "John",
              "person_height_measure": "600",
              "person_middle_name": "Quincy",
              "person_name_suffix_text": "JR",
              "person_sex_code": "1",
              "person_sur_name": "Doe",
              "person_weight_measure": "180"
            }
          }'

2.14. Test case DL000014

Sex does not match

2.14.1. Request parameters

Name Value
address_delivery_point_text_1 1515 Oak Street
address_delivery_point_text_2 APT 123
document_category_code 1
drivers_license_expiration_date 20300401
drivers_license_issue_date 20100401
identification_id DL000014
location_city_name Phoenix
location_postal_code 85000
location_state_us_postal_service_code AZ
message_destination_id AZ
person_birth_date 19700401
person_eye_color_code GRN
person_given_name John
person_height_measure 600
person_middle_name Quincy
person_name_suffix_text JR
person_sex_code 1
person_sur_name Doe
person_weight_measure 180

2.14.2. Response parameters

Name Value
address_city_match_indicator TRUE
address_line1_match_indicator TRUE
address_line2_match_indicator TRUE
address_state_code_match_indicator TRUE
address_zip4_match_indicator TRUE
address_zip5_match_indicator TRUE
document_category_match_indicator TRUE
drivers_license_expiration_date_match_indicator TRUE
drivers_license_issue_date_match_indicator TRUE
drivers_license_number_match_indicator TRUE
person_birth_date_match_indicator TRUE
person_eye_color_match_indicator TRUE
person_first_name_exact_match_indicator TRUE
person_first_name_fuzzy_alternate_match_indicator FALSE
person_first_name_fuzzy_primary_match_indicator FALSE
person_height_match_indicator TRUE
person_last_name_exact_match_indicator TRUE
person_last_name_fuzzy_alternate_match_indicator FALSE
person_last_name_fuzzy_primary_match_indicator FALSE
person_middle_initial_match_indicator TRUE
person_middle_name_exact_match_indicator TRUE
person_middle_name_fuzzy_alternate_match_indicator FALSE
person_middle_name_fuzzy_primary_match_indicator FALSE
person_name_suffix_match_indicator TRUE
person_sex_code_match_indicator FALSE
person_weight_match_indicator FALSE
replay NULL
transaction_locator_id UUID

2.14.3. Example cURL request

curl -X "POST" "https://idproof-cert.trusona.net/api/v2/verifications" \
     -H 'Content-Type: application/json' \
     -H 'Authorization: Bearer <YOUR API TOKEN>' \
     -d $'{
            "aamva": {
              "address_delivery_point_text_1": "1515 Oak Street",
              "address_delivery_point_text_2": "APT 123",
              "document_category_code": "1",
              "drivers_license_expiration_date": "20300401",
              "drivers_license_issue_date": "20100401",
              "identification_id": "DL000014",
              "location_city_name": "Phoenix",
              "location_postal_code": "85000",
              "location_state_us_postal_service_code": "AZ",
              "message_destination_id": "AZ",
              "person_birth_date": "19700401",
              "person_eye_color_code": "GRN",
              "person_given_name": "John",
              "person_height_measure": "600",
              "person_middle_name": "Quincy",
              "person_name_suffix_text": "JR",
              "person_sex_code": "1",
              "person_sur_name": "Doe",
              "person_weight_measure": "180"
            }
          }'

2.15. Test case DL000015

First w/ fuzzy match, not exact match

2.15.1. Request parameters

Name Value
address_delivery_point_text_1 1515 Oak Street
address_delivery_point_text_2 APT 123
document_category_code 1
drivers_license_expiration_date 20300401
drivers_license_issue_date 20100401
identification_id DL000015
location_city_name Phoenix
location_postal_code 85000
location_state_us_postal_service_code AZ
message_destination_id AZ
person_birth_date 19700401
person_eye_color_code GRN
person_given_name John
person_height_measure 600
person_middle_name Quincy
person_name_suffix_text JR
person_sex_code 1
person_sur_name Doe
person_weight_measure 180

2.15.2. Response parameters

Name Value
address_city_match_indicator TRUE
address_line1_match_indicator TRUE
address_line2_match_indicator TRUE
address_state_code_match_indicator TRUE
address_zip4_match_indicator TRUE
address_zip5_match_indicator TRUE
document_category_match_indicator TRUE
drivers_license_expiration_date_match_indicator TRUE
drivers_license_issue_date_match_indicator TRUE
drivers_license_number_match_indicator TRUE
person_birth_date_match_indicator TRUE
person_eye_color_match_indicator TRUE
person_first_name_exact_match_indicator FALSE
person_first_name_fuzzy_alternate_match_indicator TRUE
person_first_name_fuzzy_primary_match_indicator TRUE
person_height_match_indicator TRUE
person_last_name_exact_match_indicator TRUE
person_last_name_fuzzy_alternate_match_indicator FALSE
person_last_name_fuzzy_primary_match_indicator FALSE
person_middle_initial_match_indicator TRUE
person_middle_name_exact_match_indicator TRUE
person_middle_name_fuzzy_alternate_match_indicator FALSE
person_middle_name_fuzzy_primary_match_indicator FALSE
person_name_suffix_match_indicator TRUE
person_sex_code_match_indicator TRUE
person_weight_match_indicator TRUE
replay NULL
transaction_locator_id UUID

2.15.3. Example cURL request

curl -X "POST" "https://idproof-cert.trusona.net/api/v2/verifications" \
     -H 'Content-Type: application/json' \
     -H 'Authorization: Bearer <YOUR API TOKEN>' \
     -d $'{
            "aamva": {
              "address_delivery_point_text_1": "1515 Oak Street",
              "address_delivery_point_text_2": "APT 123",
              "document_category_code": "1",
              "drivers_license_expiration_date": "20300401",
              "drivers_license_issue_date": "20100401",
              "identification_id": "DL000015",
              "location_city_name": "Phoenix",
              "location_postal_code": "85000",
              "location_state_us_postal_service_code": "AZ",
              "message_destination_id": "AZ",
              "person_birth_date": "19700401",
              "person_eye_color_code": "GRN",
              "person_given_name": "John",
              "person_height_measure": "600",
              "person_middle_name": "Quincy",
              "person_name_suffix_text": "JR",
              "person_sex_code": "1",
              "person_sur_name": "Doe",
              "person_weight_measure": "180"
            }
          }'

2.16. Test case DL000016

Middle w/ fuzzy match, not exact match

2.16.1. Request parameters

Name Value
address_delivery_point_text_1 1515 Oak Street
address_delivery_point_text_2 APT 123
document_category_code 1
drivers_license_expiration_date 20300401
drivers_license_issue_date 20100401
identification_id DL000016
location_city_name Phoenix
location_postal_code 85000
location_state_us_postal_service_code AZ
message_destination_id AZ
person_birth_date 19700401
person_eye_color_code GRN
person_given_name John
person_height_measure 600
person_middle_name Quincy
person_name_suffix_text JR
person_sex_code 1
person_sur_name Doe
person_weight_measure 180

2.16.2. Response parameters

Name Value
address_city_match_indicator TRUE
address_line1_match_indicator TRUE
address_line2_match_indicator TRUE
address_state_code_match_indicator TRUE
address_zip4_match_indicator TRUE
address_zip5_match_indicator TRUE
document_category_match_indicator TRUE
drivers_license_expiration_date_match_indicator TRUE
drivers_license_issue_date_match_indicator TRUE
drivers_license_number_match_indicator TRUE
person_birth_date_match_indicator TRUE
person_eye_color_match_indicator TRUE
person_first_name_exact_match_indicator TRUE
person_first_name_fuzzy_alternate_match_indicator FALSE
person_first_name_fuzzy_primary_match_indicator FALSE
person_height_match_indicator TRUE
person_last_name_exact_match_indicator TRUE
person_last_name_fuzzy_alternate_match_indicator FALSE
person_last_name_fuzzy_primary_match_indicator FALSE
person_middle_initial_match_indicator TRUE
person_middle_name_exact_match_indicator FALSE
person_middle_name_fuzzy_alternate_match_indicator TRUE
person_middle_name_fuzzy_primary_match_indicator TRUE
person_name_suffix_match_indicator TRUE
person_sex_code_match_indicator TRUE
person_weight_match_indicator TRUE
replay NULL
transaction_locator_id UUID

2.16.3. Example cURL request

curl -X "POST" "https://idproof-cert.trusona.net/api/v2/verifications" \
     -H 'Content-Type: application/json' \
     -H 'Authorization: Bearer <YOUR API TOKEN>' \
     -d $'{
            "aamva": {
              "address_delivery_point_text_1": "1515 Oak Street",
              "address_delivery_point_text_2": "APT 123",
              "document_category_code": "1",
              "drivers_license_expiration_date": "20300401",
              "drivers_license_issue_date": "20100401",
              "identification_id": "DL000016",
              "location_city_name": "Phoenix",
              "location_postal_code": "85000",
              "location_state_us_postal_service_code": "AZ",
              "message_destination_id": "AZ",
              "person_birth_date": "19700401",
              "person_eye_color_code": "GRN",
              "person_given_name": "John",
              "person_height_measure": "600",
              "person_middle_name": "Quincy",
              "person_name_suffix_text": "JR",
              "person_sex_code": "1",
              "person_sur_name": "Doe",
              "person_weight_measure": "180"
            }
          }'

2.17. Test case DL000017

Last w/ fuzzy match, not exact match

2.17.1. Request parameters

Name Value
address_delivery_point_text_1 1515 Oak Street
address_delivery_point_text_2 APT 123
document_category_code 1
drivers_license_expiration_date 20300401
drivers_license_issue_date 20100401
identification_id DL000017
location_city_name Phoenix
location_postal_code 85000
location_state_us_postal_service_code AZ
message_destination_id AZ
person_birth_date 19700401
person_eye_color_code GRN
person_given_name John
person_height_measure 600
person_middle_name Quincy
person_name_suffix_text JR
person_sex_code 1
person_sur_name Doe
person_weight_measure 180

2.17.2. Response parameters

Name Value
address_city_match_indicator TRUE
address_line1_match_indicator TRUE
address_line2_match_indicator TRUE
address_state_code_match_indicator TRUE
address_zip4_match_indicator TRUE
address_zip5_match_indicator TRUE
document_category_match_indicator TRUE
drivers_license_expiration_date_match_indicator TRUE
drivers_license_issue_date_match_indicator TRUE
drivers_license_number_match_indicator TRUE
person_birth_date_match_indicator TRUE
person_eye_color_match_indicator TRUE
person_first_name_exact_match_indicator TRUE
person_first_name_fuzzy_alternate_match_indicator FALSE
person_first_name_fuzzy_primary_match_indicator FALSE
person_height_match_indicator TRUE
person_last_name_exact_match_indicator FALSE
person_last_name_fuzzy_alternate_match_indicator TRUE
person_last_name_fuzzy_primary_match_indicator TRUE
person_middle_initial_match_indicator TRUE
person_middle_name_exact_match_indicator TRUE
person_middle_name_fuzzy_alternate_match_indicator FALSE
person_middle_name_fuzzy_primary_match_indicator FALSE
person_name_suffix_match_indicator TRUE
person_sex_code_match_indicator TRUE
person_weight_match_indicator TRUE
replay NULL
transaction_locator_id UUID

2.17.3. Example cURL request

curl -X "POST" "https://idproof-cert.trusona.net/api/v2/verifications" \
     -H 'Content-Type: application/json' \
     -H 'Authorization: Bearer <YOUR API TOKEN>' \
     -d $'{
            "aamva": {
              "address_delivery_point_text_1": "1515 Oak Street",
              "address_delivery_point_text_2": "APT 123",
              "document_category_code": "1",
              "drivers_license_expiration_date": "20300401",
              "drivers_license_issue_date": "20100401",
              "identification_id": "DL000017",
              "location_city_name": "Phoenix",
              "location_postal_code": "85000",
              "location_state_us_postal_service_code": "AZ",
              "message_destination_id": "AZ",
              "person_birth_date": "19700401",
              "person_eye_color_code": "GRN",
              "person_given_name": "John",
              "person_height_measure": "600",
              "person_middle_name": "Quincy",
              "person_name_suffix_text": "JR",
              "person_sex_code": "1",
              "person_sur_name": "Doe",
              "person_weight_measure": "180"
            }
          }'

2.18. Test case DL000018

All name fields with fuzzy match, not exact match

2.18.1. Request parameters

Name Value
address_delivery_point_text_1 1515 Oak Street
address_delivery_point_text_2 APT 123
document_category_code 1
drivers_license_expiration_date 20300401
drivers_license_issue_date 20100401
identification_id DL000018
location_city_name Phoenix
location_postal_code 85000
location_state_us_postal_service_code AZ
message_destination_id AZ
person_birth_date 19700401
person_eye_color_code GRN
person_given_name John
person_height_measure 600
person_middle_name Quincy
person_name_suffix_text JR
person_sex_code 1
person_sur_name Doe
person_weight_measure 180

2.18.2. Response parameters

Name Value
address_city_match_indicator TRUE
address_line1_match_indicator TRUE
address_line2_match_indicator TRUE
address_state_code_match_indicator TRUE
address_zip4_match_indicator TRUE
address_zip5_match_indicator TRUE
document_category_match_indicator TRUE
drivers_license_expiration_date_match_indicator TRUE
drivers_license_issue_date_match_indicator TRUE
drivers_license_number_match_indicator TRUE
person_birth_date_match_indicator TRUE
person_eye_color_match_indicator TRUE
person_first_name_exact_match_indicator FALSE
person_first_name_fuzzy_alternate_match_indicator TRUE
person_first_name_fuzzy_primary_match_indicator TRUE
person_height_match_indicator TRUE
person_last_name_exact_match_indicator FALSE
person_last_name_fuzzy_alternate_match_indicator TRUE
person_last_name_fuzzy_primary_match_indicator TRUE
person_middle_initial_match_indicator FALSE
person_middle_name_exact_match_indicator FALSE
person_middle_name_fuzzy_alternate_match_indicator TRUE
person_middle_name_fuzzy_primary_match_indicator TRUE
person_name_suffix_match_indicator TRUE
person_sex_code_match_indicator TRUE
person_weight_match_indicator TRUE
replay NULL
transaction_locator_id UUID

2.18.3. Example cURL request

curl -X "POST" "https://idproof-cert.trusona.net/api/v2/verifications" \
     -H 'Content-Type: application/json' \
     -H 'Authorization: Bearer <YOUR API TOKEN>' \
     -d $'{
            "aamva": {
              "address_delivery_point_text_1": "1515 Oak Street",
              "address_delivery_point_text_2": "APT 123",
              "document_category_code": "1",
              "drivers_license_expiration_date": "20300401",
              "drivers_license_issue_date": "20100401",
              "identification_id": "DL000018",
              "location_city_name": "Phoenix",
              "location_postal_code": "85000",
              "location_state_us_postal_service_code": "AZ",
              "message_destination_id": "AZ",
              "person_birth_date": "19700401",
              "person_eye_color_code": "GRN",
              "person_given_name": "John",
              "person_height_measure": "600",
              "person_middle_name": "Quincy",
              "person_name_suffix_text": "JR",
              "person_sex_code": "1",
              "person_sur_name": "Doe",
              "person_weight_measure": "180"
            }
          }'

2.19. Test case DL000019

Middle initial matches, but middle name does not match

2.19.1. Request parameters

Name Value
address_delivery_point_text_1 1515 Oak Street
address_delivery_point_text_2 APT 123
document_category_code 1
drivers_license_expiration_date 20300401
drivers_license_issue_date 20100401
identification_id DL000019
location_city_name Phoenix
location_postal_code 85000
location_state_us_postal_service_code AZ
message_destination_id AZ
person_birth_date 19700401
person_eye_color_code GRN
person_given_name John
person_height_measure 600
person_middle_name Quincy
person_name_suffix_text JR
person_sex_code 1
person_sur_name Doe
person_weight_measure 180

2.19.2. Response parameters

Name Value
address_city_match_indicator TRUE
address_line1_match_indicator TRUE
address_line2_match_indicator TRUE
address_state_code_match_indicator TRUE
address_zip4_match_indicator TRUE
address_zip5_match_indicator TRUE
document_category_match_indicator TRUE
drivers_license_expiration_date_match_indicator TRUE
drivers_license_issue_date_match_indicator TRUE
drivers_license_number_match_indicator TRUE
person_birth_date_match_indicator TRUE
person_eye_color_match_indicator TRUE
person_first_name_exact_match_indicator TRUE
person_first_name_fuzzy_alternate_match_indicator FALSE
person_first_name_fuzzy_primary_match_indicator FALSE
person_height_match_indicator TRUE
person_last_name_exact_match_indicator TRUE
person_last_name_fuzzy_alternate_match_indicator FALSE
person_last_name_fuzzy_primary_match_indicator FALSE
person_middle_initial_match_indicator TRUE
person_middle_name_exact_match_indicator FALSE
person_middle_name_fuzzy_alternate_match_indicator FALSE
person_middle_name_fuzzy_primary_match_indicator FALSE
person_name_suffix_match_indicator TRUE
person_sex_code_match_indicator TRUE
person_weight_match_indicator TRUE
replay NULL
transaction_locator_id UUID

2.19.3. Example cURL request

curl -X "POST" "https://idproof-cert.trusona.net/api/v2/verifications" \
     -H 'Content-Type: application/json' \
     -H 'Authorization: Bearer <YOUR API TOKEN>' \
     -d $'{
            "aamva": {
              "address_delivery_point_text_1": "1515 Oak Street",
              "address_delivery_point_text_2": "APT 123",
              "document_category_code": "1",
              "drivers_license_expiration_date": "20300401",
              "drivers_license_issue_date": "20100401",
              "identification_id": "DL000019",
              "location_city_name": "Phoenix",
              "location_postal_code": "85000",
              "location_state_us_postal_service_code": "AZ",
              "message_destination_id": "AZ",
              "person_birth_date": "19700401",
              "person_eye_color_code": "GRN",
              "person_given_name": "John",
              "person_height_measure": "600",
              "person_middle_name": "Quincy",
              "person_name_suffix_text": "JR",
              "person_sex_code": "1",
              "person_sur_name": "Doe",
              "person_weight_measure": "180"
            }
          }'

2.20. Test case DL000020

Name suffix does not match

2.20.1. Request parameters

Name Value
address_delivery_point_text_1 1515 Oak Street
address_delivery_point_text_2 APT 123
document_category_code 1
drivers_license_expiration_date 20300401
drivers_license_issue_date 20100401
identification_id DL000020
location_city_name Phoenix
location_postal_code 85000
location_state_us_postal_service_code AZ
message_destination_id AZ
person_birth_date 19700401
person_eye_color_code GRN
person_given_name John
person_height_measure 600
person_middle_name Quincy
person_name_suffix_text JR
person_sex_code 1
person_sur_name Doe
person_weight_measure 180

2.20.2. Response parameters

Name Value
address_city_match_indicator TRUE
address_line1_match_indicator TRUE
address_line2_match_indicator TRUE
address_state_code_match_indicator TRUE
address_zip4_match_indicator TRUE
address_zip5_match_indicator TRUE
document_category_match_indicator TRUE
drivers_license_expiration_date_match_indicator TRUE
drivers_license_issue_date_match_indicator TRUE
drivers_license_number_match_indicator TRUE
person_birth_date_match_indicator TRUE
person_eye_color_match_indicator TRUE
person_first_name_exact_match_indicator TRUE
person_first_name_fuzzy_alternate_match_indicator FALSE
person_first_name_fuzzy_primary_match_indicator FALSE
person_height_match_indicator TRUE
person_last_name_exact_match_indicator TRUE
person_last_name_fuzzy_alternate_match_indicator FALSE
person_last_name_fuzzy_primary_match_indicator FALSE
person_middle_initial_match_indicator TRUE
person_middle_name_exact_match_indicator TRUE
person_middle_name_fuzzy_alternate_match_indicator FALSE
person_middle_name_fuzzy_primary_match_indicator FALSE
person_name_suffix_match_indicator FALSE
person_sex_code_match_indicator TRUE
person_weight_match_indicator TRUE
replay NULL
transaction_locator_id UUID

2.20.3. Example cURL request

curl -X "POST" "https://idproof-cert.trusona.net/api/v2/verifications" \
     -H 'Content-Type: application/json' \
     -H 'Authorization: Bearer <YOUR API TOKEN>' \
     -d $'{
            "aamva": {
              "address_delivery_point_text_1": "1515 Oak Street",
              "address_delivery_point_text_2": "APT 123",
              "document_category_code": "1",
              "drivers_license_expiration_date": "20300401",
              "drivers_license_issue_date": "20100401",
              "identification_id": "DL000020",
              "location_city_name": "Phoenix",
              "location_postal_code": "85000",
              "location_state_us_postal_service_code": "AZ",
              "message_destination_id": "AZ",
              "person_birth_date": "19700401",
              "person_eye_color_code": "GRN",
              "person_given_name": "John",
              "person_height_measure": "600",
              "person_middle_name": "Quincy",
              "person_name_suffix_text": "JR",
              "person_sex_code": "1",
              "person_sur_name": "Doe",
              "person_weight_measure": "180"
            }
          }'

2.21. Test case DL000021

DL number does not match

2.21.1. Request parameters

Name Value
address_delivery_point_text_1 1515 Oak Street
address_delivery_point_text_2 APT 123
document_category_code 1
drivers_license_expiration_date 20300401
drivers_license_issue_date 20100401
identification_id DL000021
location_city_name Phoenix
location_postal_code 85000
location_state_us_postal_service_code AZ
message_destination_id AZ
person_birth_date 19700401
person_eye_color_code GRN
person_given_name John
person_height_measure 600
person_middle_name Quincy
person_name_suffix_text JR
person_sex_code 1
person_sur_name Doe
person_weight_measure 180

2.21.2. Response parameters

Name Value
address_city_match_indicator TRUE
address_line1_match_indicator TRUE
address_line2_match_indicator TRUE
address_state_code_match_indicator TRUE
address_zip4_match_indicator TRUE
address_zip5_match_indicator TRUE
document_category_match_indicator TRUE
drivers_license_expiration_date_match_indicator TRUE
drivers_license_issue_date_match_indicator TRUE
drivers_license_number_match_indicator FALSE
person_birth_date_match_indicator TRUE
person_eye_color_match_indicator TRUE
person_first_name_exact_match_indicator TRUE
person_first_name_fuzzy_alternate_match_indicator FALSE
person_first_name_fuzzy_primary_match_indicator FALSE
person_height_match_indicator TRUE
person_last_name_exact_match_indicator TRUE
person_last_name_fuzzy_alternate_match_indicator FALSE
person_last_name_fuzzy_primary_match_indicator FALSE
person_middle_initial_match_indicator TRUE
person_middle_name_exact_match_indicator TRUE
person_middle_name_fuzzy_alternate_match_indicator FALSE
person_middle_name_fuzzy_primary_match_indicator FALSE
person_name_suffix_match_indicator TRUE
person_sex_code_match_indicator TRUE
person_weight_match_indicator TRUE
replay NULL
transaction_locator_id UUID

2.21.3. Example cURL request

curl -X "POST" "https://idproof-cert.trusona.net/api/v2/verifications" \
     -H 'Content-Type: application/json' \
     -H 'Authorization: Bearer <YOUR API TOKEN>' \
     -d $'{
            "aamva": {
              "address_delivery_point_text_1": "1515 Oak Street",
              "address_delivery_point_text_2": "APT 123",
              "document_category_code": "1",
              "drivers_license_expiration_date": "20300401",
              "drivers_license_issue_date": "20100401",
              "identification_id": "DL000021",
              "location_city_name": "Phoenix",
              "location_postal_code": "85000",
              "location_state_us_postal_service_code": "AZ",
              "message_destination_id": "AZ",
              "person_birth_date": "19700401",
              "person_eye_color_code": "GRN",
              "person_given_name": "John",
              "person_height_measure": "600",
              "person_middle_name": "Quincy",
              "person_name_suffix_text": "JR",
              "person_sex_code": "1",
              "person_sur_name": "Doe",
              "person_weight_measure": "180"
            }
          }'

2.22. Test case DL000022

Some fields could not be matched because the DMV/MVD/MVA does not have the data

2.22.1. Request parameters

Name Value
address_delivery_point_text_1 1515 Oak Street
address_delivery_point_text_2 APT 123
document_category_code 1
drivers_license_expiration_date 20300401
drivers_license_issue_date 20100401
identification_id DL000022
location_city_name Phoenix
location_postal_code 85000
location_state_us_postal_service_code AZ
message_destination_id AZ
person_birth_date 19700401
person_eye_color_code GRN
person_given_name John
person_height_measure 600
person_middle_name Quincy
person_name_suffix_text JR
person_sex_code 1
person_sur_name Doe
person_weight_measure 180

2.22.2. Response parameters

Name Value
address_city_match_indicator TRUE
address_line1_match_indicator TRUE
address_line2_match_indicator TRUE
address_state_code_match_indicator TRUE
address_zip4_match_indicator TRUE
address_zip5_match_indicator TRUE
document_category_match_indicator TRUE
drivers_license_expiration_date_match_indicator TRUE
drivers_license_issue_date_match_indicator TRUE
drivers_license_number_match_indicator FALSE
person_birth_date_match_indicator TRUE
person_eye_color_match_indicator NULL
person_first_name_exact_match_indicator TRUE
person_first_name_fuzzy_alternate_match_indicator FALSE
person_first_name_fuzzy_primary_match_indicator FALSE
person_height_match_indicator NULL
person_last_name_exact_match_indicator TRUE
person_last_name_fuzzy_alternate_match_indicator FALSE
person_last_name_fuzzy_primary_match_indicator FALSE
person_middle_initial_match_indicator TRUE
person_middle_name_exact_match_indicator TRUE
person_middle_name_fuzzy_alternate_match_indicator FALSE
person_middle_name_fuzzy_primary_match_indicator FALSE
person_name_suffix_match_indicator NULL
person_sex_code_match_indicator TRUE
person_weight_match_indicator NULL
replay NULL
transaction_locator_id UUID

2.22.3. Example cURL request

curl -X "POST" "https://idproof-cert.trusona.net/api/v2/verifications" \
     -H 'Content-Type: application/json' \
     -H 'Authorization: Bearer <YOUR API TOKEN>' \
     -d $'{
            "aamva": {
              "address_delivery_point_text_1": "1515 Oak Street",
              "address_delivery_point_text_2": "APT 123",
              "document_category_code": "1",
              "drivers_license_expiration_date": "20300401",
              "drivers_license_issue_date": "20100401",
              "identification_id": "DL000022",
              "location_city_name": "Phoenix",
              "location_postal_code": "85000",
              "location_state_us_postal_service_code": "AZ",
              "message_destination_id": "AZ",
              "person_birth_date": "19700401",
              "person_eye_color_code": "GRN",
              "person_given_name": "John",
              "person_height_measure": "600",
              "person_middle_name": "Quincy",
              "person_name_suffix_text": "JR",
              "person_sex_code": "1",
              "person_sur_name": "Doe",
              "person_weight_measure": "180"
            }
          }'

2.23. Test case DL000023

Very long first and last name (which are truncated) but all fields still match

2.23.1. Request parameters

Name Value
address_delivery_point_text_1 1515 Oak Street
address_delivery_point_text_2 APT 123
document_category_code 1
drivers_license_expiration_date 20300401
drivers_license_issue_date 20100401
identification_id DL000023
location_city_name Phoenix
location_postal_code 85000
location_state_us_postal_service_code AZ
message_destination_id AZ
person_birth_date 19700401
person_eye_color_code GRN
person_given_name JohnAAAAAAAAAAAAAAAAAAAAAA
person_height_measure 600
person_middle_name QuincyAAAAAAAAAAAAAAAAAAAAAAA
person_name_suffix_text JR
person_sex_code 1
person_sur_name DoeAAAAAAAAAAAAAAAAAAAAAAAAA
person_weight_measure 180

2.23.2. Response parameters

Name Value
address_city_match_indicator TRUE
address_line1_match_indicator TRUE
address_line2_match_indicator TRUE
address_state_code_match_indicator TRUE
address_zip4_match_indicator TRUE
address_zip5_match_indicator TRUE
document_category_match_indicator TRUE
drivers_license_expiration_date_match_indicator TRUE
drivers_license_issue_date_match_indicator TRUE
drivers_license_number_match_indicator TRUE
person_birth_date_match_indicator TRUE
person_eye_color_match_indicator TRUE
person_first_name_exact_match_indicator TRUE
person_first_name_fuzzy_alternate_match_indicator FALSE
person_first_name_fuzzy_primary_match_indicator FALSE
person_height_match_indicator TRUE
person_last_name_exact_match_indicator TRUE
person_last_name_fuzzy_alternate_match_indicator FALSE
person_last_name_fuzzy_primary_match_indicator FALSE
person_middle_initial_match_indicator TRUE
person_middle_name_exact_match_indicator TRUE
person_middle_name_fuzzy_alternate_match_indicator FALSE
person_middle_name_fuzzy_primary_match_indicator FALSE
person_name_suffix_match_indicator TRUE
person_sex_code_match_indicator TRUE
person_weight_match_indicator TRUE
replay NULL
transaction_locator_id UUID

2.23.3. Example cURL request

curl -X "POST" "https://idproof-cert.trusona.net/api/v2/verifications" \
     -H 'Content-Type: application/json' \
     -H 'Authorization: Bearer <YOUR API TOKEN>' \
     -d $'{
            "aamva": {
              "address_delivery_point_text_1": "1515 Oak Street",
              "address_delivery_point_text_2": "APT 123",
              "document_category_code": "1",
              "drivers_license_expiration_date": "20300401",
              "drivers_license_issue_date": "20100401",
              "identification_id": "DL000023",
              "location_city_name": "Phoenix",
              "location_postal_code": "85000",
              "location_state_us_postal_service_code": "AZ",
              "message_destination_id": "AZ",
              "person_birth_date": "19700401",
              "person_eye_color_code": "GRN",
              "person_given_name": "JohnAAAAAAAAAAAAAAAAAAAAAA",
              "person_height_measure": "600",
              "person_middle_name": "QuincyAAAAAAAAAAAAAAAAAAAAAAA",
              "person_name_suffix_text": "JR",
              "person_sex_code": "1",
              "person_sur_name": "DoeAAAAAAAAAAAAAAAAAAAAAAAAA",
              "person_weight_measure": "180"
            }
          }'

2.24. Test case DL000024

No middle name, all fields matching

2.24.1. Request parameters

Name Value
address_delivery_point_text_1 1515 Oak Street
address_delivery_point_text_2 APT 123
document_category_code 1
drivers_license_expiration_date 20300401
drivers_license_issue_date 20100401
identification_id DL000024
location_city_name Phoenix
location_postal_code 85000
location_state_us_postal_service_code AZ
message_destination_id AZ
person_birth_date 19700401
person_eye_color_code GRN
person_given_name John
person_height_measure 600
person_middle_name  
person_name_suffix_text JR
person_sex_code 1
person_sur_name Doe
person_weight_measure 180

2.24.2. Response parameters

Name Value
address_city_match_indicator TRUE
address_line1_match_indicator TRUE
address_line2_match_indicator TRUE
address_state_code_match_indicator TRUE
address_zip4_match_indicator TRUE
address_zip5_match_indicator TRUE
document_category_match_indicator TRUE
drivers_license_expiration_date_match_indicator TRUE
drivers_license_issue_date_match_indicator TRUE
drivers_license_number_match_indicator TRUE
person_birth_date_match_indicator TRUE
person_eye_color_match_indicator TRUE
person_first_name_exact_match_indicator TRUE
person_first_name_fuzzy_alternate_match_indicator FALSE
person_first_name_fuzzy_primary_match_indicator FALSE
person_height_match_indicator TRUE
person_last_name_exact_match_indicator TRUE
person_last_name_fuzzy_alternate_match_indicator FALSE
person_last_name_fuzzy_primary_match_indicator FALSE
person_middle_initial_match_indicator NULL
person_middle_name_exact_match_indicator NULL
person_middle_name_fuzzy_alternate_match_indicator NULL
person_middle_name_fuzzy_primary_match_indicator FALSE
person_name_suffix_match_indicator TRUE
person_sex_code_match_indicator TRUE
person_weight_match_indicator TRUE
replay NULL
transaction_locator_id UUID

2.24.3. Example cURL request

curl -X "POST" "https://idproof-cert.trusona.net/api/v2/verifications" \
     -H 'Content-Type: application/json' \
     -H 'Authorization: Bearer <YOUR API TOKEN>' \
     -d $'{
            "aamva": {
              "address_delivery_point_text_1": "1515 Oak Street",
              "address_delivery_point_text_2": "APT 123",
              "document_category_code": "1",
              "drivers_license_expiration_date": "20300401",
              "drivers_license_issue_date": "20100401",
              "identification_id": "DL000024",
              "location_city_name": "Phoenix",
              "location_postal_code": "85000",
              "location_state_us_postal_service_code": "AZ",
              "message_destination_id": "AZ",
              "person_birth_date": "19700401",
              "person_eye_color_code": "GRN",
              "person_given_name": "John",
              "person_height_measure": "600",
              "person_middle_name": "",
              "person_name_suffix_text": "JR",
              "person_sex_code": "1",
              "person_sur_name": "Doe",
              "person_weight_measure": "180"
            }
          }'

Integrations

Desktop
IAM and SSO
SCIM
PAM
Productivity
VPN
General

Guides

Get started guides
Implementation guides
Users guides

SDKs

Mobile SDKs
Server SDKs
Web SDKs

APIs

Authentication Service
ID Proofing Service
Mobile Auth for Browsers Service

TOTP

Business
E-commerce
Finance
Productivity
Social
Gaming
Other