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

Errors

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

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

Validation messages can include transaction_id is required, msisdn is required, channel is required, length or format errors, and an unsupported-operator error. Correct the request before retrying a 422 response.

Last modified on October 23, 2026
Activity ResultsPhone Active v2