PrivyPrivy
Sign in
  • Documentation
Back to Documentation
B2B Telco APIs
OverviewChangelog
Phone Active
Phone Match
Phone Location Verification
    v1
      Phone Location Verification v1QuickstartEnvironmentsAuthenticationRequest FieldsLocation ResultsErrors
    v2
    v3
Phone Income Score
API Explorer
powered by Zudoku
Sign in
v1

Errors

Failed Phone Location Verification v1 requests return status: "failed" and a message describing the failure.

HTTP statusMeaningCommon causes
400Request timeout or upstream access failureThe location request could not be completed in time.
401Authentication failedMissing or invalid credentials, timestamp, or signature.
403ForbiddenThe merchant or channel is not enabled for Phone Location Verification.
422Validation failedMissing or invalid request fields, incompatible location fields, or unsupported operator.
500Processing failedThe operator request could not be processed.
503MaintenanceThe service is temporarily unavailable.

Validation messages can identify an invalid transaction_id, msisdn, location_type, check_type, location value, channel, or operator. Correct the request before retrying a 422 response.

Last modified on October 23, 2026
Location ResultsPhone Location Verification v2