A successful Lookup API response will have an HTTP status code set to 200.

    For any unsuccessful response, you can refer to the below-mentioned table. Plivo Lookup error codes can be used to identify the reason for not receiving number information. This Error Code is part of the API response.

    Plivo Error Codes

    Http Status CodesPlivo Error CodesReasonDescription



    Auth ID and/or Auth Token is invalid.

    This response is received when the customer uses invalid credentials to access the API.



    Account does not have sufficient balance to fulfill the request.

    Prepaid account has insufficient balance. This error is not applicable for postpaid customers. Please recharge your account.

    Account is forbidden from accessing resource.

    Customer has not been subscribed to the Lookup Service. Please contact Plivo Support in this case.

    Phone number is invalid or does not exist.

    Phone number is either invalid or doesn’t exist

    Request type not specified or is invalid.

    Lookup API requires the query parameter type to be set in the request. This error occurs when this parameter is missing or if the value passed with the parameter is invalid.

    Check Number Lookup API docs to know more about the API parameters.


    Failed to process request due to internal server failure.

    Set when Plivo is not able to process the API request due to internal issues.

    Contact Plivo Support in this case.

    5XXNAContact Plivo Support in this case.