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

Request Fields

Send an application/json body to POST /api/v3/phone/location.

FieldTypeRequiredValidation
transaction_idstringYes1–36 alphanumeric or hyphen characters; unique for the merchant request.
msisdnstringYes7–15 digits in normalized international format; must be an XL, Axis, or Smartfren number.
location_typestringYeshome or work.
check_typestringYesaddress or coordinates.
addressstringWhen check_type is address1–255 characters.
latstringWhen check_type is coordinatesValid latitude, 3–15 characters.
longstringWhen check_type is coordinatesValid longitude, 3–15 characters.
channelstringYes1–100 alphanumeric or hyphen characters.

Only send the location field required by the selected check_type.

Code
{ "transaction_id": "location-v3-001", "msisdn": "628171234567", "location_type": "work", "check_type": "address", "address": "Jl. Jenderal Sudirman, Jakarta", "channel": "web" }
Last modified on October 23, 2026
AuthenticationLocation Results
JSON