Error and Status Codes

Sandbox You are viewing Sandbox mode docs. Switch using the toggle on the dashboard.

TDS Risk APIs use two related code layers on most endpoints: the HTTP status code on the transport response (for example 400, 500), and an app-level status field in the JSON response body, where a value of 0 indicates success. This page lists the shared HTTP and JSON status codes returned across Trust Score, Mobile KYC, and Risk Recall. Individual endpoint reference pages may document extra values.

HTTP status codes
CODE DEFINITION DESCRIPTION
200 OK Request completed successfully.
400 Bad Request Invalid request or parameter.
401 Unauthorized Missing or invalid authentication credentials.
403 Forbidden Client isn't permitted to access the service.
404 Not Found No matching resource or subscriber data.
408 Request Timeout The upstream data provider timed out waiting for a response.
410 Not Available The requested URI is no longer available.
415 Unsupported Media Type Invalid Content-Type header. Set Content-Type: application/json.
500 Internal Server Error Unexpected server error. Retry the request. Contact support if it persists.
502 Bad Gateway Invalid response from an upstream service.
504 Gateway Timeout Upstream service didn't respond in time.
API status codes

When validation or processing fails, the JSON response includes a status integer and description string. An additionalInfo field may name the invalid parameter.

Example error response

{
    "requestId": "JR-1649862171",
    "status": 1000,
    "description": "Parameter is invalid.",
    "additionalInfo": "phoneNumber invalid."
}
STATUS CODE HTTP STATUS DESCRIPTION RESOLUTION
0 200 Success —
1 500 Can't process this request at this time System issue on the provider side. Retry and contact support if it persists.
2 400 Request parse failure Ensure the request body is valid JSON and retry.
3 400 Request timeout Request took too long. Retry and contact support if it persists.
4 400 Expired VFP Mobile Auth flow exceeded the allowed window. Complete authentication within 60 seconds.
1000 400 Parameter is invalid Check additionalInfo for the invalid parameter, correct the request, and retry.
1001 400 Can't identify subscriber The mobile subscriber can't be identified, or the number isn't reachable on the network.
1002 400 Subscriber isn't found on the required allowlist Sandbox only — allowlist the sandbox phone number you're testing with.
1003 400 Subscriber isn't supported for this service No data is available for this subscriber on this service.
1004 400 numberOfAddresses parameter exceeds limit Submit at most three addresses for numberOfAddresses.
1005 401 API client or operator not enabled for this service Contact your account representative to provision access for this service.
1006 400 Subscriber is suspended The network has suspended this subscriber.
1007 400 Subscriber is deactivated The carrier recently deactivated this subscriber; data is no longer available.
1008 400 Can't complete operation The carrier didn't recognize the number, or the data provider couldn't complete the transaction.
1010 400 Subscriber isn't eligible for the service No data is available for the mobile subscriber.
1012 400 No CRM data available No data is available for the mobile subscriber.
1014 400 Challenge mismatch Correct the challenge input data and retry.
1021 401 Token invalid Obtain a new access token and retry.
1022 401 Session expired Token expired. Obtain a new access token and retry.
1025 400 Invalid parameters Ensure Content-Type: application/json and all request parameters are valid.
1038 400 Carrier mismatch Carrier information in the response doesn't match carrier information on file.
1039 400 Transaction hasn't completed Processing is still in progress. Wait and retry.
1102, 1103 500 Can't reach the external provider The upstream data provider is unreachable. Retry later.
1120 400 Not a valid or active number Review the phone number and retry with a valid number.
2061 400 Deceased person detected The identity associated with the phone number has a death indicator on file.
API Overview