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

Request Fields

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

FieldTypeRequiredValidation
transaction_idstringYes1–36 alphanumeric or hyphen characters; unique for the merchant request.
msisdnstringYes7–15 digits in normalized international format; must be a Telkomsel number.
location_typestringYeshome or work.
check_typestringYesaddress, coordinates, or zipcode.
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.
zip_codestringWhen check_type is zipcodeExactly five digits.
channelstringYes1–100 alphanumeric or hyphen characters.

Only send the location field required by the selected check_type.

Code
{ "transaction_id": "location-v1-001", "msisdn": "628111234567", "location_type": "home", "check_type": "zipcode", "zip_code": "12190", "channel": "web" }
Last modified on October 23, 2026
AuthenticationLocation Results
JSON