Title Analysis
Retrieves the results of a title analysis by the unique task ID
curl --request GET \
--url https://dev.cardinalgray.com/title_analysis/{id} \
--header 'Authorization: Bearer <token>'{
"id": "<string>",
"status": "complete",
"analysis": {
"title_data": {
"state": "<string>",
"number": "<string>",
"date_of_issue": "<string>",
"vin": "<string>",
"year": "<string>",
"make": "<string>",
"model": "<string>",
"body_style": "<string>",
"odometer": "<string>",
"fuel_type": "<string>",
"is_or": true,
"is_and": true,
"owners": [
{
"customer_id": "<string>",
"full_name": "<string>",
"dob": "<string>",
"dlid": {
"number": "<string>",
"state": "AL",
"sex": "<string>",
"expiration_date": "<string>",
"first_name": "<string>",
"middle_name": "<string>",
"last_name": "<string>",
"addr": {
"recipient_name": "<string>",
"street1": "<string>",
"street2": "<string>",
"city": "<string>",
"county": "<string>",
"state": "AL",
"zip": "<string>"
}
},
"ssn": "<string>",
"addr": {
"recipient_name": "<string>",
"street1": "<string>",
"street2": "<string>",
"city": "<string>",
"county": "<string>",
"state": "AL",
"zip": "<string>"
},
"addr_mailing": {
"recipient_name": "<string>",
"street1": "<string>",
"street2": "<string>",
"city": "<string>",
"county": "<string>",
"state": "AL",
"zip": "<string>"
},
"contact_phone": "<string>",
"contact_email": "<string>",
"insurance": {
"provider_name": "<string>",
"provider_naic": "<string>",
"policy_number": "<string>"
},
"ownership_type": "<string>"
}
],
"liens": [
{
"lienholder_name": "<string>",
"lienholder_address": {
"recipient_name": "<string>",
"street1": "<string>",
"street2": "<string>",
"city": "<string>",
"county": "<string>",
"state": "AL",
"zip": "<string>"
},
"lien_date": "<string>",
"lien_satisfied_date": "<string>"
}
]
},
"nmvtis_data": {
"record_match_sequence_id": "<string>",
"title_issue_date": "<string>",
"title_issuing_authority_name": "<string>",
"vehicle_identification": "<string>",
"vehicle_odometer_reading_measure": "<string>"
},
"is_match": {
"owner": true,
"vin": true,
"issue_date": true,
"state": true
}
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Unique identifier for the title analysis task
Response
Unique identifier for the task
Current status of the task
complete, pending, failure Results of the title analysis.
The state where the title is registered
The state issued title number
The date the title was issued
Vehicle Identification Number
Year of the vehicle
Make of the vehicle
Model of the vehicle
Body style of the vehicle
Odometer reading
Type of fuel used by the vehicle
Indicates if the title is registered to multiple owners with 'or' condition
Indicates if the title is registered to multiple owners with 'and' condition
List of owners of the vehicle
Primary street address line
City name
Two-letter state code
AL, AK, AZ, AR, CA, CO, CT, DC, DE, FL, GA, HI, ID, IL, IN, IA, KS, KY, LA, ME, MD, MA, MI, MN, MS, MO, MT, NE, NV, NH, NJ, NM, NY, NC, ND, OH, OK, OR, PA, RI, SC, SD, TN, TX, UT, VT, VA, WA, WV, WI, WY, DC 5 or 9 digit ZIP code
Optional name of recipient at this address
Secondary street address line (apt, suite, etc.)
County name
Driver's license number
State that issued the license
AL, AK, AZ, AR, CA, CO, CT, DC, DE, FL, GA, HI, ID, IL, IN, IA, KS, KY, LA, ME, MD, MA, MI, MN, MS, MO, MT, NE, NV, NH, NJ, NM, NY, NC, ND, OH, OK, OR, PA, RI, SC, SD, TN, TX, UT, VT, VA, WA, WV, WI, WY, DC Sex as listed on license
License expiration date (MM-DD-YYYY or MM/DD/YYYY)
First name on license
Middle name on license
Last name on license
Address as listed on license
Primary street address line
City name
Two-letter state code
AL, AK, AZ, AR, CA, CO, CT, DC, DE, FL, GA, HI, ID, IL, IN, IA, KS, KY, LA, ME, MD, MA, MI, MN, MS, MO, MT, NE, NV, NH, NJ, NM, NY, NC, ND, OH, OK, OR, PA, RI, SC, SD, TN, TX, UT, VT, VA, WA, WV, WI, WY, DC 5 or 9 digit ZIP code
Optional name of recipient at this address
Secondary street address line (apt, suite, etc.)
County name
List of liens against the vehicle
Name of the lienholder
Address of the lienholder
Primary street address line
City name
Two-letter state code
AL, AK, AZ, AR, CA, CO, CT, DC, DE, FL, GA, HI, ID, IL, IN, IA, KS, KY, LA, ME, MD, MA, MI, MN, MS, MO, MT, NE, NV, NH, NJ, NM, NY, NC, ND, OH, OK, OR, PA, RI, SC, SD, TN, TX, UT, VT, VA, WA, WV, WI, WY, DC 5 or 9 digit ZIP code
Optional name of recipient at this address
Secondary street address line (apt, suite, etc.)
County name
Date when the lien was registered
Date when the lien was satisfied, if applicable
The state where the title is registered
NMVTIS's data on the most recent title issue date
The jurisdiction issuing the title. For example: VA
Vehicle Identification Number
The odometer reading at the time of the last title issue
True when the owner name passed matches the owner name extracted from the title
True when the VIN passed matches the VIN extracted from the title
True when the issue date passed matches the most recent issue date recorded with NMVTIS
True when the state passed matches the issuing authority (i.e. state) recorded with NMVTIS
curl --request GET \
--url https://dev.cardinalgray.com/title_analysis/{id} \
--header 'Authorization: Bearer <token>'{
"id": "<string>",
"status": "complete",
"analysis": {
"title_data": {
"state": "<string>",
"number": "<string>",
"date_of_issue": "<string>",
"vin": "<string>",
"year": "<string>",
"make": "<string>",
"model": "<string>",
"body_style": "<string>",
"odometer": "<string>",
"fuel_type": "<string>",
"is_or": true,
"is_and": true,
"owners": [
{
"customer_id": "<string>",
"full_name": "<string>",
"dob": "<string>",
"dlid": {
"number": "<string>",
"state": "AL",
"sex": "<string>",
"expiration_date": "<string>",
"first_name": "<string>",
"middle_name": "<string>",
"last_name": "<string>",
"addr": {
"recipient_name": "<string>",
"street1": "<string>",
"street2": "<string>",
"city": "<string>",
"county": "<string>",
"state": "AL",
"zip": "<string>"
}
},
"ssn": "<string>",
"addr": {
"recipient_name": "<string>",
"street1": "<string>",
"street2": "<string>",
"city": "<string>",
"county": "<string>",
"state": "AL",
"zip": "<string>"
},
"addr_mailing": {
"recipient_name": "<string>",
"street1": "<string>",
"street2": "<string>",
"city": "<string>",
"county": "<string>",
"state": "AL",
"zip": "<string>"
},
"contact_phone": "<string>",
"contact_email": "<string>",
"insurance": {
"provider_name": "<string>",
"provider_naic": "<string>",
"policy_number": "<string>"
},
"ownership_type": "<string>"
}
],
"liens": [
{
"lienholder_name": "<string>",
"lienholder_address": {
"recipient_name": "<string>",
"street1": "<string>",
"street2": "<string>",
"city": "<string>",
"county": "<string>",
"state": "AL",
"zip": "<string>"
},
"lien_date": "<string>",
"lien_satisfied_date": "<string>"
}
]
},
"nmvtis_data": {
"record_match_sequence_id": "<string>",
"title_issue_date": "<string>",
"title_issuing_authority_name": "<string>",
"vehicle_identification": "<string>",
"vehicle_odometer_reading_measure": "<string>"
},
"is_match": {
"owner": true,
"vin": true,
"issue_date": true,
"state": true
}
}
}