Troubleshooting Phone Verification API Errors

In this section, we will cover some of the most common errors clients find when implementing the API. Reviewing this information will help you pinpoint problems and resolve them quickly. We also recommend that you check out our guide to XVerify’s phone verification response codes.

  1. Inactive account error: The first most common error is if your account is not activated and you attempt to make the API call. If you see this error message please contact us by phone at 1-866-903-9164 or send us an email to

    bad phone

    Notice how the response code is 503 and the status indicates you have a bad request. However, our message output will still help you easily identify what went wrong. This is an example of what happens when you try to make API requests after your account is no longer activated.

  2. Wrong API key error: Another common error message you find is when you attempt to perform a verification and but, you have input the wrong API key. We recommend you first double check your API URL inside of your account and make sure that it matches.

    api error
    In this error message, you will again find the status is a bad request and the response code is the same as before. Take note of the message tag, it indicates exactly what the problem is so that you can quickly fix the issue.

  3. Trusted domain error: You might also find an error message if you decide to place XVerify on another web property but forget to add it as a trusted domain. Trusted domains are an important part of keeping your account secure and making sure no one else gets hold of your API key and attempts to use your account for unauthorized verifications.

    bad api
    So here in this bad request, you will find that if you attempt to make a phone verification when you did not have the domain name added to your trusted list. This will also produce the 503 error code and you will see that the message clearly states it is denying your request due to an unauthorized domain name.

  4. Missing data error: If you were trying to perform a phone verification, and you did not fill in the API call with the phone number you will get response code 400.

    missing data in api

    Notice here that the status indicates you have supplied bad data. The message tells you, that you have missing fields.