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

    An unsuccessful Lookup API response returns an api_id, an error code, and an error message. This table gives more information about error codes and what caused them, and suggests actions to take if you receive an error response.

    Plivo Lookup Error Codes

    HTTP Status CodesPlivo Error CodesReasonDescription
    401401Auth ID and/or Auth Token is invalid.You receive this response when you use invalid credentials to access the API.
    402402Account 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.
    403403Account is forbidden from accessing resource.Customer has not been subscribed to the Lookup Service. Please contact Plivo support.
    404404Phone number is invalid or does not exist.Phone number is either invalid or doesn’t exist.
    400160Request 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 the Number Lookup API documentation to learn about the API parameters.
    500300Failed to process request due to internal server failure.Plivo is unable to process the API request due to internal issues.

    Contact Plivo support.
    5XXNA Contact Plivo support.