Lookup status messages

The status of the call can be found in the response's header under Message:

Message (in JSON response header) Comments
OK Request has been successfully sent and valid responses are being returned back.
Bad query: Invalid phone number This API supports United States, Canada, United Kingdom, Ireland, Australia, Singapore and France mobile phone numbers. For the United States and Canada, the coverage extends to landline numbers as well.
Bad query: Invalid input parameter value Check the parameter values you've entered are valid. Possible causes:
  • Missing a mandatory parameter
  • The country code that you have supplied is invalid
Bad query: Malformed JSON in request Request has been successfully sent but no responses are being returned. Possible causes:
  • Invalid JSON format
  • Blank values are being sent
Bad query: Missing security token The token is missing in the request's header or the URL.
Bad query: Missing query id parameter in URL The query id parameter is missing in the URL.
Resource not found The requested resource could not be found but may be available again in the future. Subsequent requests by the client are permissible.
Unauthorized: Token not recognized Provided token is incorrect. Please check your token: log into the Self Service Portal > Licenses.
Forbidden: Product not matched Request is not authorized to use the service.
Forbidden: Entitlement disabled Your token has run out of credits. To find token information, log into the Self Service Portal > Licenses.
Phone number has too few digits The submitted phone number is too short - it has to contain the following number of digits (excluding the country code):
  • North America: 10
  • United Kingdom: 10
  • Australia: 9
  • France: 9
  • Ireland: 9
  • Singapore: 8
Phone number has too many digits The submitted phone number is too long - it cannot exceed the following number of digits (excluding the country code):
  • North America: 10
  • United Kingdom: 10
  • Australia: 9
  • France: 9
  • Ireland: 9
  • Singapore: 8
Forbidden: Your IP address is not whitelisted. This IP address does not have access to your integration. To whitelist it, log into the Self Service Portal > Licenses.
Forbidden: Your origin domain is not defined. This domain does not have access to your integration. To allow access to it, log into the Self Service Portal > Licenses.