Test Case Overview

Test caseDescription
DL000001All fields match exactly
DL000002No fields match exactly
DL000003Street address does not match
DL000004City in address does not match
DL000005State in address does not match
DL000006ZIP-5 in address does not match
DL000007ZIP-4 in address does not match
DL000008Document category does not match
DL000009Drivers license expiration date does not match
DL000010Drivers license issue date does not match
DL000011Eye color does not match
DL000012Height does not match
DL000013Weight does not match
DL000014Sex does not match
DL000015First w/ fuzzy match, not exact match
DL000016Middle w/ fuzzy match, not exact match
DL000017Last w/ fuzzy match, not exact match
DL000018All name fields with fuzzy match, not exact match
DL000019Middle initial matches, but middle name does not match
DL000020Name suffix does not match
DL000021DL number does not match
DL000022Some fields could not be matched because the DMV/MVD/MVA does not have the data
DL000023Very long first and last name (which are truncated) but all fields still match
DL000024No middle name, all fields matching

Test Case 1

All fields match exactly

Request parameters

NameValue
address_delivery_point_text_11515 Oak Street
address_delivery_point_text_2APT 123
document_category_code1
drivers_license_expiration_date20300401
drivers_license_issue_date20100401
identification_idDL000001
location_city_namePhoenix
location_postal_code85000
location_state_us_postal_service_codeAZ
message_destination_idAZ
person_birth_date19700401
person_eye_color_codeGRN
person_given_nameJohn
person_height_measure600
person_middle_nameQuincy
person_name_suffix_textJR
person_sex_code1
person_sur_nameDoe
person_weight_measure180

Response parameters

NameValue
address_city_match_indicatorTRUE
address_line1_match_indicatorTRUE
address_line2_match_indicatorTRUE
address_state_code_match_indicatorTRUE
address_zip4_match_indicatorTRUE
address_zip5_match_indicatorTRUE
document_category_match_indicatorTRUE
drivers_license_expiration_date_match_indicatorTRUE
drivers_license_issue_date_match_indicatorTRUE
drivers_license_number_match_indicatorTRUE
person_birth_date_match_indicatorTRUE
person_eye_color_match_indicatorTRUE
person_first_name_exact_match_indicatorTRUE
person_first_name_fuzzy_alternate_match_indicatorFALSE
person_first_name_fuzzy_primary_match_indicatorFALSE
person_height_match_indicatorTRUE
person_last_name_exact_match_indicatorTRUE
person_last_name_fuzzy_alternate_match_indicatorFALSE
person_last_name_fuzzy_primary_match_indicatorFALSE
person_middle_initial_match_indicatorTRUE
person_middle_name_exact_match_indicatorTRUE
person_middle_name_fuzzy_alternate_match_indicatorFALSE
person_middle_name_fuzzy_primary_match_indicatorFALSE
person_name_suffix_match_indicatorTRUE
person_sex_code_match_indicatorTRUE
person_weight_match_indicatorTRUE
replayNULL
transaction_locator_idUUID

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"
              }
            }'

Test Case 2

No fields match exactly

Request parameters

NameValue
address_delivery_point_text_11515 Oak Street
address_delivery_point_text_2APT 123
document_category_code1
drivers_license_expiration_date20300401
drivers_license_issue_date20100401
identification_idDL000002
location_city_namePhoenix
location_postal_code85000
location_state_us_postal_service_codeAZ
message_destination_idAZ
person_birth_date19700401
person_eye_color_codeGRN
person_given_nameJohn
person_height_measure600
person_middle_nameQuincy
person_name_suffix_textJR
person_sex_code1
person_sur_nameDoe
person_weight_measure180

Response parameters

NameValue
address_city_match_indicatorFALSE
address_line1_match_indicatorFALSE
address_line2_match_indicatorFALSE
address_state_code_match_indicatorFALSE
address_zip4_match_indicatorFALSE
address_zip5_match_indicatorFALSE
document_category_match_indicatorFALSE
drivers_license_expiration_date_match_indicatorFALSE
drivers_license_issue_date_match_indicatorFALSE
drivers_license_number_match_indicatorFALSE
person_birth_date_match_indicatorFALSE
person_eye_color_match_indicatorFALSE
person_first_name_exact_match_indicatorFALSE
person_first_name_fuzzy_alternate_match_indicatorFALSE
person_first_name_fuzzy_primary_match_indicatorFALSE
person_height_match_indicatorFALSE
person_last_name_exact_match_indicatorFALSE
person_last_name_fuzzy_alternate_match_indicatorFALSE
person_last_name_fuzzy_primary_match_indicatorFALSE
person_middle_initial_match_indicatorFALSE
person_middle_name_exact_match_indicatorFALSE
person_middle_name_fuzzy_alternate_match_indicatorFALSE
person_middle_name_fuzzy_primary_match_indicatorFALSE
person_name_suffix_match_indicatorFALSE
person_sex_code_match_indicatorFALSE
person_weight_match_indicatorFALSE
replayNULL
transaction_locator_idUUID

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"
              }
            }'

Test Case 3

Street address does not match

Request parameters

NameValue
address_delivery_point_text_11515 Oak Street
address_delivery_point_text_2APT 123
document_category_code1
drivers_license_expiration_date20300401
drivers_license_issue_date20100401
identification_idDL000003
location_city_namePhoenix
location_postal_code85000
location_state_us_postal_service_codeAZ
message_destination_idAZ
person_birth_date19700401
person_eye_color_codeGRN
person_given_nameJohn
person_height_measure600
person_middle_nameQuincy
person_name_suffix_textJR
person_sex_code1
person_sur_nameDoe
person_weight_measure180

Response parameters

NameValue
address_city_match_indicatorTRUE
address_line1_match_indicatorFALSE
address_line2_match_indicatorFALSE
address_state_code_match_indicatorTRUE
address_zip4_match_indicatorTRUE
address_zip5_match_indicatorTRUE
document_category_match_indicatorTRUE
drivers_license_expiration_date_match_indicatorTRUE
drivers_license_issue_date_match_indicatorTRUE
drivers_license_number_match_indicatorTRUE
person_birth_date_match_indicatorTRUE
person_eye_color_match_indicatorTRUE
person_first_name_exact_match_indicatorTRUE
person_first_name_fuzzy_alternate_match_indicatorFALSE
person_first_name_fuzzy_primary_match_indicatorFALSE
person_height_match_indicatorTRUE
person_last_name_exact_match_indicatorTRUE
person_last_name_fuzzy_alternate_match_indicatorFALSE
person_last_name_fuzzy_primary_match_indicatorFALSE
person_middle_initial_match_indicatorTRUE
person_middle_name_exact_match_indicatorTRUE
person_middle_name_fuzzy_alternate_match_indicatorFALSE
person_middle_name_fuzzy_primary_match_indicatorFALSE
person_name_suffix_match_indicatorTRUE
person_sex_code_match_indicatorTRUE
person_weight_match_indicatorTRUE
replayNULL
transaction_locator_idUUID

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"
              }
            }'

Test Case 4

City in address does not match

Request parameters

NameValue
address_delivery_point_text_11515 Oak Street
address_delivery_point_text_2APT 123
document_category_code1
drivers_license_expiration_date20300401
drivers_license_issue_date20100401
identification_idDL000004
location_city_namePhoenix
location_postal_code85000
location_state_us_postal_service_codeAZ
message_destination_idAZ
person_birth_date19700401
person_eye_color_codeGRN
person_given_nameJohn
person_height_measure600
person_middle_nameQuincy
person_name_suffix_textJR
person_sex_code1
person_sur_nameDoe
person_weight_measure180

Response parameters

NameValue
address_city_match_indicatorFALSE
address_line1_match_indicatorTRUE
address_line2_match_indicatorTRUE
address_state_code_match_indicatorTRUE
address_zip4_match_indicatorTRUE
address_zip5_match_indicatorTRUE
document_category_match_indicatorTRUE
drivers_license_expiration_date_match_indicatorTRUE
drivers_license_issue_date_match_indicatorTRUE
drivers_license_number_match_indicatorTRUE
person_birth_date_match_indicatorTRUE
person_eye_color_match_indicatorTRUE
person_first_name_exact_match_indicatorTRUE
person_first_name_fuzzy_alternate_match_indicatorFALSE
person_first_name_fuzzy_primary_match_indicatorFALSE
person_height_match_indicatorTRUE
person_last_name_exact_match_indicatorTRUE
person_last_name_fuzzy_alternate_match_indicatorFALSE
person_last_name_fuzzy_primary_match_indicatorFALSE
person_middle_initial_match_indicatorTRUE
person_middle_name_exact_match_indicatorTRUE
person_middle_name_fuzzy_alternate_match_indicatorFALSE
person_middle_name_fuzzy_primary_match_indicatorFALSE
person_name_suffix_match_indicatorTRUE
person_sex_code_match_indicatorTRUE
person_weight_match_indicatorTRUE
replayNULL
transaction_locator_idUUID

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"
              }
            }'

Test Case 5

State in address does not match

Request parameters

NameValue
address_delivery_point_text_11515 Oak Street
address_delivery_point_text_2APT 123
document_category_code1
drivers_license_expiration_date20300401
drivers_license_issue_date20100401
identification_idDL000005
location_city_namePhoenix
location_postal_code85000
location_state_us_postal_service_codeAZ
message_destination_idAZ
person_birth_date19700401
person_eye_color_codeGRN
person_given_nameJohn
person_height_measure600
person_middle_nameQuincy
person_name_suffix_textJR
person_sex_code1
person_sur_nameDoe
person_weight_measure180

Response parameters

NameValue
address_city_match_indicatorTRUE
address_line1_match_indicatorTRUE
address_line2_match_indicatorTRUE
address_state_code_match_indicatorFALSE
address_zip4_match_indicatorTRUE
address_zip5_match_indicatorTRUE
document_category_match_indicatorTRUE
drivers_license_expiration_date_match_indicatorTRUE
drivers_license_issue_date_match_indicatorTRUE
drivers_license_number_match_indicatorTRUE
person_birth_date_match_indicatorTRUE
person_eye_color_match_indicatorTRUE
person_first_name_exact_match_indicatorTRUE
person_first_name_fuzzy_alternate_match_indicatorFALSE
person_first_name_fuzzy_primary_match_indicatorFALSE
person_height_match_indicatorTRUE
person_last_name_exact_match_indicatorTRUE
person_last_name_fuzzy_alternate_match_indicatorFALSE
person_last_name_fuzzy_primary_match_indicatorFALSE
person_middle_initial_match_indicatorTRUE
person_middle_name_exact_match_indicatorTRUE
person_middle_name_fuzzy_alternate_match_indicatorFALSE
person_middle_name_fuzzy_primary_match_indicatorFALSE
person_name_suffix_match_indicatorTRUE
person_sex_code_match_indicatorTRUE
person_weight_match_indicatorTRUE
replayNULL
transaction_locator_idUUID

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"
              }
            }'

Test Case 6

ZIP-5 in address does not match

Request parameters

NameValue
address_delivery_point_text_11515 Oak Street
address_delivery_point_text_2APT 123
document_category_code1
drivers_license_expiration_date20300401
drivers_license_issue_date20100401
identification_idDL000006
location_city_namePhoenix
location_postal_code85000
location_state_us_postal_service_codeAZ
message_destination_idAZ
person_birth_date19700401
person_eye_color_codeGRN
person_given_nameJohn
person_height_measure600
person_middle_nameQuincy
person_name_suffix_textJR
person_sex_code1
person_sur_nameDoe
person_weight_measure180

Response parameters

NameValue
address_city_match_indicatorTRUE
address_line1_match_indicatorTRUE
address_line2_match_indicatorTRUE
address_state_code_match_indicatorTRUE
address_zip4_match_indicatorTRUE
address_zip5_match_indicatorFALSE
document_category_match_indicatorTRUE
drivers_license_expiration_date_match_indicatorTRUE
drivers_license_issue_date_match_indicatorTRUE
drivers_license_number_match_indicatorTRUE
person_birth_date_match_indicatorTRUE
person_eye_color_match_indicatorTRUE
person_first_name_exact_match_indicatorTRUE
person_first_name_fuzzy_alternate_match_indicatorFALSE
person_first_name_fuzzy_primary_match_indicatorFALSE
person_height_match_indicatorTRUE
person_last_name_exact_match_indicatorTRUE
person_last_name_fuzzy_alternate_match_indicatorFALSE
person_last_name_fuzzy_primary_match_indicatorFALSE
person_middle_initial_match_indicatorTRUE
person_middle_name_exact_match_indicatorTRUE
person_middle_name_fuzzy_alternate_match_indicatorFALSE
person_middle_name_fuzzy_primary_match_indicatorFALSE
person_name_suffix_match_indicatorTRUE
person_sex_code_match_indicatorTRUE
person_weight_match_indicatorTRUE
replayNULL
transaction_locator_idUUID

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"
              }
            }'

Test Case 7

ZIP-4 in address does not match

Request parameters

NameValue
address_delivery_point_text_11515 Oak Street
address_delivery_point_text_2APT 123
document_category_code1
drivers_license_expiration_date20300401
drivers_license_issue_date20100401
identification_idDL000007
location_city_namePhoenix
location_postal_code85000
location_state_us_postal_service_codeAZ
message_destination_idAZ
person_birth_date19700401
person_eye_color_codeGRN
person_given_nameJohn
person_height_measure600
person_middle_nameQuincy
person_name_suffix_textJR
person_sex_code1
person_sur_nameDoe
person_weight_measure180

Response parameters

NameValue
address_city_match_indicatorTRUE
address_line1_match_indicatorTRUE
address_line2_match_indicatorTRUE
address_state_code_match_indicatorTRUE
address_zip4_match_indicatorFALSE
address_zip5_match_indicatorTRUE
document_category_match_indicatorTRUE
drivers_license_expiration_date_match_indicatorTRUE
drivers_license_issue_date_match_indicatorTRUE
drivers_license_number_match_indicatorTRUE
person_birth_date_match_indicatorTRUE
person_eye_color_match_indicatorTRUE
person_first_name_exact_match_indicatorTRUE
person_first_name_fuzzy_alternate_match_indicatorFALSE
person_first_name_fuzzy_primary_match_indicatorFALSE
person_height_match_indicatorTRUE
person_last_name_exact_match_indicatorTRUE
person_last_name_fuzzy_alternate_match_indicatorFALSE
person_last_name_fuzzy_primary_match_indicatorFALSE
person_middle_initial_match_indicatorTRUE
person_middle_name_exact_match_indicatorTRUE
person_middle_name_fuzzy_alternate_match_indicatorFALSE
person_middle_name_fuzzy_primary_match_indicatorFALSE
person_name_suffix_match_indicatorTRUE
person_sex_code_match_indicatorTRUE
person_weight_match_indicatorTRUE
replayNULL
transaction_locator_idUUID

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"
              }
            }'

Test Case 8

Document category does not match

Request parameters

NameValue
address_delivery_point_text_11515 Oak Street
address_delivery_point_text_2APT 123
document_category_code1
drivers_license_expiration_date20300401
drivers_license_issue_date20100401
identification_idDL000008
location_city_namePhoenix
location_postal_code85000
location_state_us_postal_service_codeAZ
message_destination_idAZ
person_birth_date19700401
person_eye_color_codeGRN
person_given_nameJohn
person_height_measure600
person_middle_nameQuincy
person_name_suffix_textJR
person_sex_code1
person_sur_nameDoe
person_weight_measure180

Response parameters

NameValue
address_city_match_indicatorTRUE
address_line1_match_indicatorTRUE
address_line2_match_indicatorTRUE
address_state_code_match_indicatorTRUE
address_zip4_match_indicatorTRUE
address_zip5_match_indicatorTRUE
document_category_match_indicatorFALSE
drivers_license_expiration_date_match_indicatorTRUE
drivers_license_issue_date_match_indicatorTRUE
drivers_license_number_match_indicatorTRUE
person_birth_date_match_indicatorTRUE
person_eye_color_match_indicatorTRUE
person_first_name_exact_match_indicatorTRUE
person_first_name_fuzzy_alternate_match_indicatorFALSE
person_first_name_fuzzy_primary_match_indicatorFALSE
person_height_match_indicatorTRUE
person_last_name_exact_match_indicatorTRUE
person_last_name_fuzzy_alternate_match_indicatorFALSE
person_last_name_fuzzy_primary_match_indicatorFALSE
person_middle_initial_match_indicatorTRUE
person_middle_name_exact_match_indicatorTRUE
person_middle_name_fuzzy_alternate_match_indicatorFALSE
person_middle_name_fuzzy_primary_match_indicatorFALSE
person_name_suffix_match_indicatorTRUE
person_sex_code_match_indicatorTRUE
person_weight_match_indicatorTRUE
replayNULL
transaction_locator_idUUID

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"
              }
            }'

Test Case 9

Drivers license expiration date does not match

Request parameters

NameValue
address_delivery_point_text_11515 Oak Street
address_delivery_point_text_2APT 123
document_category_code1
drivers_license_expiration_date20300401
drivers_license_issue_date20100401
identification_idDL000009
location_city_namePhoenix
location_postal_code85000
location_state_us_postal_service_codeAZ
message_destination_idAZ
person_birth_date19700401
person_eye_color_codeGRN
person_given_nameJohn
person_height_measure600
person_middle_nameQuincy
person_name_suffix_textJR
person_sex_code1
person_sur_nameDoe
person_weight_measure180

Response parameters

NameValue
address_city_match_indicatorTRUE
address_line1_match_indicatorTRUE
address_line2_match_indicatorTRUE
address_state_code_match_indicatorTRUE
address_zip4_match_indicatorTRUE
address_zip5_match_indicatorTRUE
document_category_match_indicatorTRUE
drivers_license_expiration_date_match_indicatorTRUE
drivers_license_issue_date_match_indicatorTRUE
drivers_license_number_match_indicatorTRUE
person_birth_date_match_indicatorTRUE
person_eye_color_match_indicatorTRUE
person_first_name_exact_match_indicatorTRUE
person_first_name_fuzzy_alternate_match_indicatorFALSE
person_first_name_fuzzy_primary_match_indicatorFALSE
person_height_match_indicatorTRUE
person_last_name_exact_match_indicatorTRUE
person_last_name_fuzzy_alternate_match_indicatorFALSE
person_last_name_fuzzy_primary_match_indicatorFALSE
person_middle_initial_match_indicatorTRUE
person_middle_name_exact_match_indicatorTRUE
person_middle_name_fuzzy_alternate_match_indicatorFALSE
person_middle_name_fuzzy_primary_match_indicatorFALSE
person_name_suffix_match_indicatorTRUE
person_sex_code_match_indicatorTRUE
person_weight_match_indicatorTRUE
replayNULL
transaction_locator_idUUID

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"
              }
            }'

Test Case 10

Drivers license issue date does not match

Request parameters

NameValue
address_delivery_point_text_11515 Oak Street
address_delivery_point_text_2APT 123
document_category_code1
drivers_license_expiration_date20300401
drivers_license_issue_date20100401
identification_idDL000010
location_city_namePhoenix
location_postal_code85000
location_state_us_postal_service_codeAZ
message_destination_idAZ
person_birth_date19700401
person_eye_color_codeGRN
person_given_nameJohn
person_height_measure600
person_middle_nameQuincy
person_name_suffix_textJR
person_sex_code1
person_sur_nameDoe
person_weight_measure180

Response parameters

NameValue
address_city_match_indicatorTRUE
address_line1_match_indicatorTRUE
address_line2_match_indicatorTRUE
address_state_code_match_indicatorTRUE
address_zip4_match_indicatorTRUE
address_zip5_match_indicatorTRUE
document_category_match_indicatorTRUE
drivers_license_expiration_date_match_indicatorTRUE
drivers_license_issue_date_match_indicatorFALSE
drivers_license_number_match_indicatorTRUE
person_birth_date_match_indicatorTRUE
person_eye_color_match_indicatorTRUE
person_first_name_exact_match_indicatorTRUE
person_first_name_fuzzy_alternate_match_indicatorFALSE
person_first_name_fuzzy_primary_match_indicatorFALSE
person_height_match_indicatorTRUE
person_last_name_exact_match_indicatorTRUE
person_last_name_fuzzy_alternate_match_indicatorFALSE
person_last_name_fuzzy_primary_match_indicatorFALSE
person_middle_initial_match_indicatorTRUE
person_middle_name_exact_match_indicatorTRUE
person_middle_name_fuzzy_alternate_match_indicatorFALSE
person_middle_name_fuzzy_primary_match_indicatorFALSE
person_name_suffix_match_indicatorTRUE
person_sex_code_match_indicatorTRUE
person_weight_match_indicatorTRUE
replayNULL
transaction_locator_idUUID

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"
              }
            }'

Test Case 11

Eye color does not match

Request parameters

NameValue
address_delivery_point_text_11515 Oak Street
address_delivery_point_text_2APT 123
document_category_code1
drivers_license_expiration_date20300401
drivers_license_issue_date20100401
identification_idDL000011
location_city_namePhoenix
location_postal_code85000
location_state_us_postal_service_codeAZ
message_destination_idAZ
person_birth_date19700401
person_eye_color_codeGRN
person_given_nameJohn
person_height_measure600
person_middle_nameQuincy
person_name_suffix_textJR
person_sex_code1
person_sur_nameDoe
person_weight_measure180

Response parameters

NameValue
address_city_match_indicatorTRUE
address_line1_match_indicatorTRUE
address_line2_match_indicatorTRUE
address_state_code_match_indicatorTRUE
address_zip4_match_indicatorTRUE
address_zip5_match_indicatorTRUE
document_category_match_indicatorTRUE
drivers_license_expiration_date_match_indicatorTRUE
drivers_license_issue_date_match_indicatorTRUE
drivers_license_number_match_indicatorTRUE
person_birth_date_match_indicatorTRUE
person_eye_color_match_indicatorFALSE
person_first_name_exact_match_indicatorTRUE
person_first_name_fuzzy_alternate_match_indicatorFALSE
person_first_name_fuzzy_primary_match_indicatorFALSE
person_height_match_indicatorTRUE
person_last_name_exact_match_indicatorTRUE
person_last_name_fuzzy_alternate_match_indicatorFALSE
person_last_name_fuzzy_primary_match_indicatorFALSE
person_middle_initial_match_indicatorTRUE
person_middle_name_exact_match_indicatorTRUE
person_middle_name_fuzzy_alternate_match_indicatorFALSE
person_middle_name_fuzzy_primary_match_indicatorFALSE
person_name_suffix_match_indicatorTRUE
person_sex_code_match_indicatorTRUE
person_weight_match_indicatorTRUE
replayNULL
transaction_locator_idUUID

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"
              }
            }'

Test Case 12

Height does not match

Request parameters

NameValue
address_delivery_point_text_11515 Oak Street
address_delivery_point_text_2APT 123
document_category_code1
drivers_license_expiration_date20300401
drivers_license_issue_date20100401
identification_idDL000012
location_city_namePhoenix
location_postal_code85000
location_state_us_postal_service_codeAZ
message_destination_idAZ
person_birth_date19700401
person_eye_color_codeGRN
person_given_nameJohn
person_height_measure600
person_middle_nameQuincy
person_name_suffix_textJR
person_sex_code1
person_sur_nameDoe
person_weight_measure180

Response parameters

NameValue
address_city_match_indicatorTRUE
address_line1_match_indicatorTRUE
address_line2_match_indicatorTRUE
address_state_code_match_indicatorTRUE
address_zip4_match_indicatorTRUE
address_zip5_match_indicatorTRUE
document_category_match_indicatorTRUE
drivers_license_expiration_date_match_indicatorTRUE
drivers_license_issue_date_match_indicatorTRUE
drivers_license_number_match_indicatorTRUE
person_birth_date_match_indicatorTRUE
person_eye_color_match_indicatorTRUE
person_first_name_exact_match_indicatorTRUE
person_first_name_fuzzy_alternate_match_indicatorFALSE
person_first_name_fuzzy_primary_match_indicatorFALSE
person_height_match_indicatorFALSE
person_last_name_exact_match_indicatorTRUE
person_last_name_fuzzy_alternate_match_indicatorFALSE
person_last_name_fuzzy_primary_match_indicatorFALSE
person_middle_initial_match_indicatorTRUE
person_middle_name_exact_match_indicatorTRUE
person_middle_name_fuzzy_alternate_match_indicatorFALSE
person_middle_name_fuzzy_primary_match_indicatorFALSE
person_name_suffix_match_indicatorTRUE
person_sex_code_match_indicatorTRUE
person_weight_match_indicatorTRUE
replayNULL
transaction_locator_idUUID

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"
              }
            }'

Test Case 13

Weight does not match

Request parameters

NameValue
address_delivery_point_text_11515 Oak Street
address_delivery_point_text_2APT 123
document_category_code1
drivers_license_expiration_date20300401
drivers_license_issue_date20100401
identification_idDL000013
location_city_namePhoenix
location_postal_code85000
location_state_us_postal_service_codeAZ
message_destination_idAZ
person_birth_date19700401
person_eye_color_codeGRN
person_given_nameJohn
person_height_measure600
person_middle_nameQuincy
person_name_suffix_textJR
person_sex_code1
person_sur_nameDoe
person_weight_measure180

Response parameters

NameValue
address_city_match_indicatorTRUE
address_line1_match_indicatorTRUE
address_line2_match_indicatorTRUE
address_state_code_match_indicatorTRUE
address_zip4_match_indicatorTRUE
address_zip5_match_indicatorTRUE
document_category_match_indicatorTRUE
drivers_license_expiration_date_match_indicatorTRUE
drivers_license_issue_date_match_indicatorTRUE
drivers_license_number_match_indicatorTRUE
person_birth_date_match_indicatorTRUE
person_eye_color_match_indicatorTRUE
person_first_name_exact_match_indicatorTRUE
person_first_name_fuzzy_alternate_match_indicatorFALSE
person_first_name_fuzzy_primary_match_indicatorFALSE
person_height_match_indicatorTRUE
person_last_name_exact_match_indicatorTRUE
person_last_name_fuzzy_alternate_match_indicatorFALSE
person_last_name_fuzzy_primary_match_indicatorFALSE
person_middle_initial_match_indicatorTRUE
person_middle_name_exact_match_indicatorTRUE
person_middle_name_fuzzy_alternate_match_indicatorFALSE
person_middle_name_fuzzy_primary_match_indicatorFALSE
person_name_suffix_match_indicatorTRUE
person_sex_code_match_indicatorTRUE
person_weight_match_indicatorFALSE
replayNULL
transaction_locator_idUUID

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"
              }
            }'

Test Case 14

Sex does not match

Request parameters

NameValue
address_delivery_point_text_11515 Oak Street
address_delivery_point_text_2APT 123
document_category_code1
drivers_license_expiration_date20300401
drivers_license_issue_date20100401
identification_idDL000014
location_city_namePhoenix
location_postal_code85000
location_state_us_postal_service_codeAZ
message_destination_idAZ
person_birth_date19700401
person_eye_color_codeGRN
person_given_nameJohn
person_height_measure600
person_middle_nameQuincy
person_name_suffix_textJR
person_sex_code1
person_sur_nameDoe
person_weight_measure180

Response parameters

NameValue
address_city_match_indicatorTRUE
address_line1_match_indicatorTRUE
address_line2_match_indicatorTRUE
address_state_code_match_indicatorTRUE
address_zip4_match_indicatorTRUE
address_zip5_match_indicatorTRUE
document_category_match_indicatorTRUE
drivers_license_expiration_date_match_indicatorTRUE
drivers_license_issue_date_match_indicatorTRUE
drivers_license_number_match_indicatorTRUE
person_birth_date_match_indicatorTRUE
person_eye_color_match_indicatorTRUE
person_first_name_exact_match_indicatorTRUE
person_first_name_fuzzy_alternate_match_indicatorFALSE
person_first_name_fuzzy_primary_match_indicatorFALSE
person_height_match_indicatorTRUE
person_last_name_exact_match_indicatorTRUE
person_last_name_fuzzy_alternate_match_indicatorFALSE
person_last_name_fuzzy_primary_match_indicatorFALSE
person_middle_initial_match_indicatorTRUE
person_middle_name_exact_match_indicatorTRUE
person_middle_name_fuzzy_alternate_match_indicatorFALSE
person_middle_name_fuzzy_primary_match_indicatorFALSE
person_name_suffix_match_indicatorTRUE
person_sex_code_match_indicatorFALSE
person_weight_match_indicatorFALSE
replayNULL
transaction_locator_idUUID

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"
              }
            }'

Test Case 15

First w/ fuzzy match, not exact match

Request parameters

NameValue
address_delivery_point_text_11515 Oak Street
address_delivery_point_text_2APT 123
document_category_code1
drivers_license_expiration_date20300401
drivers_license_issue_date20100401
identification_idDL000015
location_city_namePhoenix
location_postal_code85000
location_state_us_postal_service_codeAZ
message_destination_idAZ
person_birth_date19700401
person_eye_color_codeGRN
person_given_nameJohn
person_height_measure600
person_middle_nameQuincy
person_name_suffix_textJR
person_sex_code1
person_sur_nameDoe
person_weight_measure180

Response parameters

NameValue
address_city_match_indicatorTRUE
address_line1_match_indicatorTRUE
address_line2_match_indicatorTRUE
address_state_code_match_indicatorTRUE
address_zip4_match_indicatorTRUE
address_zip5_match_indicatorTRUE
document_category_match_indicatorTRUE
drivers_license_expiration_date_match_indicatorTRUE
drivers_license_issue_date_match_indicatorTRUE
drivers_license_number_match_indicatorTRUE
person_birth_date_match_indicatorTRUE
person_eye_color_match_indicatorTRUE
person_first_name_exact_match_indicatorFALSE
person_first_name_fuzzy_alternate_match_indicatorTRUE
person_first_name_fuzzy_primary_match_indicatorTRUE
person_height_match_indicatorTRUE
person_last_name_exact_match_indicatorTRUE
person_last_name_fuzzy_alternate_match_indicatorFALSE
person_last_name_fuzzy_primary_match_indicatorFALSE
person_middle_initial_match_indicatorTRUE
person_middle_name_exact_match_indicatorTRUE
person_middle_name_fuzzy_alternate_match_indicatorFALSE
person_middle_name_fuzzy_primary_match_indicatorFALSE
person_name_suffix_match_indicatorTRUE
person_sex_code_match_indicatorTRUE
person_weight_match_indicatorTRUE
replayNULL
transaction_locator_idUUID

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"
              }
            }'

Test Case 16

Middle w/ fuzzy match, not exact match

Request parameters

NameValue
address_delivery_point_text_11515 Oak Street
address_delivery_point_text_2APT 123
document_category_code1
drivers_license_expiration_date20300401
drivers_license_issue_date20100401
identification_idDL000016
location_city_namePhoenix
location_postal_code85000
location_state_us_postal_service_codeAZ
message_destination_idAZ
person_birth_date19700401
person_eye_color_codeGRN
person_given_nameJohn
person_height_measure600
person_middle_nameQuincy
person_name_suffix_textJR
person_sex_code1
person_sur_nameDoe
person_weight_measure180

Response parameters

NameValue
address_city_match_indicatorTRUE
address_line1_match_indicatorTRUE
address_line2_match_indicatorTRUE
address_state_code_match_indicatorTRUE
address_zip4_match_indicatorTRUE
address_zip5_match_indicatorTRUE
document_category_match_indicatorTRUE
drivers_license_expiration_date_match_indicatorTRUE
drivers_license_issue_date_match_indicatorTRUE
drivers_license_number_match_indicatorTRUE
person_birth_date_match_indicatorTRUE
person_eye_color_match_indicatorTRUE
person_first_name_exact_match_indicatorTRUE
person_first_name_fuzzy_alternate_match_indicatorFALSE
person_first_name_fuzzy_primary_match_indicatorFALSE
person_height_match_indicatorTRUE
person_last_name_exact_match_indicatorTRUE
person_last_name_fuzzy_alternate_match_indicatorFALSE
person_last_name_fuzzy_primary_match_indicatorFALSE
person_middle_initial_match_indicatorTRUE
person_middle_name_exact_match_indicatorFALSE
person_middle_name_fuzzy_alternate_match_indicatorTRUE
person_middle_name_fuzzy_primary_match_indicatorTRUE
person_name_suffix_match_indicatorTRUE
person_sex_code_match_indicatorTRUE
person_weight_match_indicatorTRUE
replayNULL
transaction_locator_idUUID

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"
              }
            }'

Test Case 17

Last w/ fuzzy match, not exact match

Request parameters

NameValue
address_delivery_point_text_11515 Oak Street
address_delivery_point_text_2APT 123
document_category_code1
drivers_license_expiration_date20300401
drivers_license_issue_date20100401
identification_idDL000017
location_city_namePhoenix
location_postal_code85000
location_state_us_postal_service_codeAZ
message_destination_idAZ
person_birth_date19700401
person_eye_color_codeGRN
person_given_nameJohn
person_height_measure600
person_middle_nameQuincy
person_name_suffix_textJR
person_sex_code1
person_sur_nameDoe
person_weight_measure180

Response parameters

NameValue
address_city_match_indicatorTRUE
address_line1_match_indicatorTRUE
address_line2_match_indicatorTRUE
address_state_code_match_indicatorTRUE
address_zip4_match_indicatorTRUE
address_zip5_match_indicatorTRUE
document_category_match_indicatorTRUE
drivers_license_expiration_date_match_indicatorTRUE
drivers_license_issue_date_match_indicatorTRUE
drivers_license_number_match_indicatorTRUE
person_birth_date_match_indicatorTRUE
person_eye_color_match_indicatorTRUE
person_first_name_exact_match_indicatorTRUE
person_first_name_fuzzy_alternate_match_indicatorFALSE
person_first_name_fuzzy_primary_match_indicatorFALSE
person_height_match_indicatorTRUE
person_last_name_exact_match_indicatorFALSE
person_last_name_fuzzy_alternate_match_indicatorTRUE
person_last_name_fuzzy_primary_match_indicatorTRUE
person_middle_initial_match_indicatorTRUE
person_middle_name_exact_match_indicatorTRUE
person_middle_name_fuzzy_alternate_match_indicatorFALSE
person_middle_name_fuzzy_primary_match_indicatorFALSE
person_name_suffix_match_indicatorTRUE
person_sex_code_match_indicatorTRUE
person_weight_match_indicatorTRUE
replayNULL
transaction_locator_idUUID

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"
              }
            }'

Test Case 18

All name fields with fuzzy match, not exact match

Request parameters

NameValue
address_delivery_point_text_11515 Oak Street
address_delivery_point_text_2APT 123
document_category_code1
drivers_license_expiration_date20300401
drivers_license_issue_date20100401
identification_idDL000018
location_city_namePhoenix
location_postal_code85000
location_state_us_postal_service_codeAZ
message_destination_idAZ
person_birth_date19700401
person_eye_color_codeGRN
person_given_nameJohn
person_height_measure600
person_middle_nameQuincy
person_name_suffix_textJR
person_sex_code1
person_sur_nameDoe
person_weight_measure180

Response parameters

NameValue
address_city_match_indicatorTRUE
address_line1_match_indicatorTRUE
address_line2_match_indicatorTRUE
address_state_code_match_indicatorTRUE
address_zip4_match_indicatorTRUE
address_zip5_match_indicatorTRUE
document_category_match_indicatorTRUE
drivers_license_expiration_date_match_indicatorTRUE
drivers_license_issue_date_match_indicatorTRUE
drivers_license_number_match_indicatorTRUE
person_birth_date_match_indicatorTRUE
person_eye_color_match_indicatorTRUE
person_first_name_exact_match_indicatorFALSE
person_first_name_fuzzy_alternate_match_indicatorTRUE
person_first_name_fuzzy_primary_match_indicatorTRUE
person_height_match_indicatorTRUE
person_last_name_exact_match_indicatorFALSE
person_last_name_fuzzy_alternate_match_indicatorTRUE
person_last_name_fuzzy_primary_match_indicatorTRUE
person_middle_initial_match_indicatorFALSE
person_middle_name_exact_match_indicatorFALSE
person_middle_name_fuzzy_alternate_match_indicatorTRUE
person_middle_name_fuzzy_primary_match_indicatorTRUE
person_name_suffix_match_indicatorTRUE
person_sex_code_match_indicatorTRUE
person_weight_match_indicatorTRUE
replayNULL
transaction_locator_idUUID

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"
              }
            }'

Test Case 19

Middle initial matches, but middle name does not match

Request parameters

NameValue
address_delivery_point_text_11515 Oak Street
address_delivery_point_text_2APT 123
document_category_code1
drivers_license_expiration_date20300401
drivers_license_issue_date20100401
identification_idDL000019
location_city_namePhoenix
location_postal_code85000
location_state_us_postal_service_codeAZ
message_destination_idAZ
person_birth_date19700401
person_eye_color_codeGRN
person_given_nameJohn
person_height_measure600
person_middle_nameQuincy
person_name_suffix_textJR
person_sex_code1
person_sur_nameDoe
person_weight_measure180

Response parameters

NameValue
address_city_match_indicatorTRUE
address_line1_match_indicatorTRUE
address_line2_match_indicatorTRUE
address_state_code_match_indicatorTRUE
address_zip4_match_indicatorTRUE
address_zip5_match_indicatorTRUE
document_category_match_indicatorTRUE
drivers_license_expiration_date_match_indicatorTRUE
drivers_license_issue_date_match_indicatorTRUE
drivers_license_number_match_indicatorTRUE
person_birth_date_match_indicatorTRUE
person_eye_color_match_indicatorTRUE
person_first_name_exact_match_indicatorTRUE
person_first_name_fuzzy_alternate_match_indicatorFALSE
person_first_name_fuzzy_primary_match_indicatorFALSE
person_height_match_indicatorTRUE
person_last_name_exact_match_indicatorTRUE
person_last_name_fuzzy_alternate_match_indicatorFALSE
person_last_name_fuzzy_primary_match_indicatorFALSE
person_middle_initial_match_indicatorTRUE
person_middle_name_exact_match_indicatorFALSE
person_middle_name_fuzzy_alternate_match_indicatorFALSE
person_middle_name_fuzzy_primary_match_indicatorFALSE
person_name_suffix_match_indicatorTRUE
person_sex_code_match_indicatorTRUE
person_weight_match_indicatorTRUE
replayNULL
transaction_locator_idUUID

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"
              }
            }'

Test Case 20

Name suffix does not match

Request parameters

NameValue
address_delivery_point_text_11515 Oak Street
address_delivery_point_text_2APT 123
document_category_code1
drivers_license_expiration_date20300401
drivers_license_issue_date20100401
identification_idDL000020
location_city_namePhoenix
location_postal_code85000
location_state_us_postal_service_codeAZ
message_destination_idAZ
person_birth_date19700401
person_eye_color_codeGRN
person_given_nameJohn
person_height_measure600
person_middle_nameQuincy
person_name_suffix_textJR
person_sex_code1
person_sur_nameDoe
person_weight_measure180

Response parameters

NameValue
address_city_match_indicatorTRUE
address_line1_match_indicatorTRUE
address_line2_match_indicatorTRUE
address_state_code_match_indicatorTRUE
address_zip4_match_indicatorTRUE
address_zip5_match_indicatorTRUE
document_category_match_indicatorTRUE
drivers_license_expiration_date_match_indicatorTRUE
drivers_license_issue_date_match_indicatorTRUE
drivers_license_number_match_indicatorTRUE
person_birth_date_match_indicatorTRUE
person_eye_color_match_indicatorTRUE
person_first_name_exact_match_indicatorTRUE
person_first_name_fuzzy_alternate_match_indicatorFALSE
person_first_name_fuzzy_primary_match_indicatorFALSE
person_height_match_indicatorTRUE
person_last_name_exact_match_indicatorTRUE
person_last_name_fuzzy_alternate_match_indicatorFALSE
person_last_name_fuzzy_primary_match_indicatorFALSE
person_middle_initial_match_indicatorTRUE
person_middle_name_exact_match_indicatorTRUE
person_middle_name_fuzzy_alternate_match_indicatorFALSE
person_middle_name_fuzzy_primary_match_indicatorFALSE
person_name_suffix_match_indicatorFALSE
person_sex_code_match_indicatorTRUE
person_weight_match_indicatorTRUE
replayNULL
transaction_locator_idUUID

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"
              }
            }'

Test Case 21

DL number does not match

Request parameters

NameValue
address_delivery_point_text_11515 Oak Street
address_delivery_point_text_2APT 123
document_category_code1
drivers_license_expiration_date20300401
drivers_license_issue_date20100401
identification_idDL000021
location_city_namePhoenix
location_postal_code85000
location_state_us_postal_service_codeAZ
message_destination_idAZ
person_birth_date19700401
person_eye_color_codeGRN
person_given_nameJohn
person_height_measure600
person_middle_nameQuincy
person_name_suffix_textJR
person_sex_code1
person_sur_nameDoe
person_weight_measure180

Response parameters

NameValue
address_city_match_indicatorTRUE
address_line1_match_indicatorTRUE
address_line2_match_indicatorTRUE
address_state_code_match_indicatorTRUE
address_zip4_match_indicatorTRUE
address_zip5_match_indicatorTRUE
document_category_match_indicatorTRUE
drivers_license_expiration_date_match_indicatorTRUE
drivers_license_issue_date_match_indicatorTRUE
drivers_license_number_match_indicatorFALSE
person_birth_date_match_indicatorTRUE
person_eye_color_match_indicatorTRUE
person_first_name_exact_match_indicatorTRUE
person_first_name_fuzzy_alternate_match_indicatorFALSE
person_first_name_fuzzy_primary_match_indicatorFALSE
person_height_match_indicatorTRUE
person_last_name_exact_match_indicatorTRUE
person_last_name_fuzzy_alternate_match_indicatorFALSE
person_last_name_fuzzy_primary_match_indicatorFALSE
person_middle_initial_match_indicatorTRUE
person_middle_name_exact_match_indicatorTRUE
person_middle_name_fuzzy_alternate_match_indicatorFALSE
person_middle_name_fuzzy_primary_match_indicatorFALSE
person_name_suffix_match_indicatorTRUE
person_sex_code_match_indicatorTRUE
person_weight_match_indicatorTRUE
replayNULL
transaction_locator_idUUID

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"
              }
            }'

Test Case 22

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

Request parameters

NameValue
address_delivery_point_text_11515 Oak Street
address_delivery_point_text_2APT 123
document_category_code1
drivers_license_expiration_date20300401
drivers_license_issue_date20100401
identification_idDL000022
location_city_namePhoenix
location_postal_code85000
location_state_us_postal_service_codeAZ
message_destination_idAZ
person_birth_date19700401
person_eye_color_codeGRN
person_given_nameJohn
person_height_measure600
person_middle_nameQuincy
person_name_suffix_textJR
person_sex_code1
person_sur_nameDoe
person_weight_measure180

Response parameters

NameValue
address_city_match_indicatorTRUE
address_line1_match_indicatorTRUE
address_line2_match_indicatorTRUE
address_state_code_match_indicatorTRUE
address_zip4_match_indicatorTRUE
address_zip5_match_indicatorTRUE
document_category_match_indicatorTRUE
drivers_license_expiration_date_match_indicatorTRUE
drivers_license_issue_date_match_indicatorTRUE
drivers_license_number_match_indicatorFALSE
person_birth_date_match_indicatorTRUE
person_eye_color_match_indicatorNULL
person_first_name_exact_match_indicatorTRUE
person_first_name_fuzzy_alternate_match_indicatorFALSE
person_first_name_fuzzy_primary_match_indicatorFALSE
person_height_match_indicatorNULL
person_last_name_exact_match_indicatorTRUE
person_last_name_fuzzy_alternate_match_indicatorFALSE
person_last_name_fuzzy_primary_match_indicatorFALSE
person_middle_initial_match_indicatorTRUE
person_middle_name_exact_match_indicatorTRUE
person_middle_name_fuzzy_alternate_match_indicatorFALSE
person_middle_name_fuzzy_primary_match_indicatorFALSE
person_name_suffix_match_indicatorNULL
person_sex_code_match_indicatorTRUE
person_weight_match_indicatorNULL
replayNULL
transaction_locator_idUUID

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"
              }
            }'

Test Case 23

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

Request parameters

NameValue
address_delivery_point_text_11515 Oak Street
address_delivery_point_text_2APT 123
document_category_code1
drivers_license_expiration_date20300401
drivers_license_issue_date20100401
identification_idDL000023
location_city_namePhoenix
location_postal_code85000
location_state_us_postal_service_codeAZ
message_destination_idAZ
person_birth_date19700401
person_eye_color_codeGRN
person_given_nameJohnAAAAAAAAAAAAAAAAAAAAAA
person_height_measure600
person_middle_nameQuincyAAAAAAAAAAAAAAAAAAAAAAA
person_name_suffix_textJR
person_sex_code1
person_sur_nameDoeAAAAAAAAAAAAAAAAAAAAAAAAA
person_weight_measure180

Response parameters

NameValue
address_city_match_indicatorTRUE
address_line1_match_indicatorTRUE
address_line2_match_indicatorTRUE
address_state_code_match_indicatorTRUE
address_zip4_match_indicatorTRUE
address_zip5_match_indicatorTRUE
document_category_match_indicatorTRUE
drivers_license_expiration_date_match_indicatorTRUE
drivers_license_issue_date_match_indicatorTRUE
drivers_license_number_match_indicatorTRUE
person_birth_date_match_indicatorTRUE
person_eye_color_match_indicatorTRUE
person_first_name_exact_match_indicatorTRUE
person_first_name_fuzzy_alternate_match_indicatorFALSE
person_first_name_fuzzy_primary_match_indicatorFALSE
person_height_match_indicatorTRUE
person_last_name_exact_match_indicatorTRUE
person_last_name_fuzzy_alternate_match_indicatorFALSE
person_last_name_fuzzy_primary_match_indicatorFALSE
person_middle_initial_match_indicatorTRUE
person_middle_name_exact_match_indicatorTRUE
person_middle_name_fuzzy_alternate_match_indicatorFALSE
person_middle_name_fuzzy_primary_match_indicatorFALSE
person_name_suffix_match_indicatorTRUE
person_sex_code_match_indicatorTRUE
person_weight_match_indicatorTRUE
replayNULL
transaction_locator_idUUID

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"
              }
            }'

Test Case 24

No middle name, all fields matching

Request parameters

NameValue
address_delivery_point_text_11515 Oak Street
address_delivery_point_text_2APT 123
document_category_code1
drivers_license_expiration_date20300401
drivers_license_issue_date20100401
identification_idDL000024
location_city_namePhoenix
location_postal_code85000
location_state_us_postal_service_codeAZ
message_destination_idAZ
person_birth_date19700401
person_eye_color_codeGRN
person_given_nameJohn
person_height_measure600
person_middle_name
person_name_suffix_textJR
person_sex_code1
person_sur_nameDoe
person_weight_measure180

Response parameters

NameValue
address_city_match_indicatorTRUE
address_line1_match_indicatorTRUE
address_line2_match_indicatorTRUE
address_state_code_match_indicatorTRUE
address_zip4_match_indicatorTRUE
address_zip5_match_indicatorTRUE
document_category_match_indicatorTRUE
drivers_license_expiration_date_match_indicatorTRUE
drivers_license_issue_date_match_indicatorTRUE
drivers_license_number_match_indicatorTRUE
person_birth_date_match_indicatorTRUE
person_eye_color_match_indicatorTRUE
person_first_name_exact_match_indicatorTRUE
person_first_name_fuzzy_alternate_match_indicatorFALSE
person_first_name_fuzzy_primary_match_indicatorFALSE
person_height_match_indicatorTRUE
person_last_name_exact_match_indicatorTRUE
person_last_name_fuzzy_alternate_match_indicatorFALSE
person_last_name_fuzzy_primary_match_indicatorFALSE
person_middle_initial_match_indicatorNULL
person_middle_name_exact_match_indicatorNULL
person_middle_name_fuzzy_alternate_match_indicatorNULL
person_middle_name_fuzzy_primary_match_indicatorFALSE
person_name_suffix_match_indicatorTRUE
person_sex_code_match_indicatorTRUE
person_weight_match_indicatorTRUE
replayNULL
transaction_locator_idUUID

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"
              }
            }'

Further Reading

Trusona ID Proofing Integration Guide