See Errors for a full description of each of the errors listed below.
The API uses HTTP response codes to indicate the status of a request. In general, codes in the 2xx range indicate success, codes in the 4xx range indicate that a failure occurred due to the content or structure of the request (e.g., a required parameter was omitted, the authentication header is missing, etc.), and codes in the 5xx range indicate a server error. 5xx errors are rare, and should be handled by emailing Trulioo support. Here are some troubleshooting tips for the more common 4xx errors:
Details should be included in the body of the response. Some example causes of a 400 BadRequest are:
Account not configured for this product
Ensure you are configured properly with the Get Country Codes request to see the countries you are configured for.
Configuration name not valid
For now, you should always send "Identity Verification" for the configuration name parameter.
Unable to find account
Email Trulioo support to ensure there are no issues with your account.
Transaction not available
Make sure that you are sending the correct TransactionRecordID and that the verify was sent from this same request.
Account not configured for this country.
Try the Get Country Codes request to see the countries you are configured for.
The user name and password you provided is not valid or you are using an account that does not have API permissions. Make a call to Test Authentication with your username/password in the Authentication header. If you do not see your username echoed back at you, you are using the incorrect password or account.
If you are using one of our generated code samples and are receiving the response "Missing authorization header" see Authorization Headers to get examples of how to add them to each language.
If the request you sent is over the current limit.
You asked for a media type that we do not support. Make sure your request includes a Content-Type: application/json header.
Service errors are caused by invalid customer data, datasource errors, and address correction/address validation issues. Each error includes a code, indicating the category of service error, and a detailed error message.
Provider Error - There was an error connecting to the source
Missing Required Field
Datasource Unavailable - the source did not respond
Datasource Error - The source returned an error
State not supported (AU Driver license)
Missing consent - consent not sent for the source
Unrecognized Field Name
Invalid Field Format
Unrecognized Field group
Request Timed Out
Duplicate Field received
State Province Changed
Street Info Changed
Postal Code Changed
Missing Address Info
Cannot validate address
Address validation is not available
Missing Required Field: MobileNumber
Invalid Mobile Number
Mobile Carrier Not Supported
See the Verify documentation for JSON examples of how errors are returned.