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

Income Score Results

A successful Phone Income Score v1 request returns HTTP 200.

FieldTypeDescription
codeintegerHTTP-aligned result code.
statusstringsuccess.
client_transaction_idstringThe submitted transaction_id.
dataobjectsocial economy results for the number.
balanceintegerRemaining balance or postpaid usage representation.
transaction_idstringPrivy's transaction identifier.
messagestringphone income score successful.

Data object

FieldTypeDescription
phonestringNormalized mobile number.
operatorstringDetected mobile operator.
scorestringSocioeconomic score returned for the number.

Score values

ScoreDescription
AThe highest social economy status
B
C
D
EThe lowest social economy status
Code
{ "code": 200, "status": "success", "client_transaction_id": "ses-v1-001", "data": { "phone": "628111234567", "operator": "Telkomsel", "score": "A" }, "balance": 100, "transaction_id": "019c1234-5678-7abc-8def-0123456789ab", "message": "phone income score successful" }
Last modified on October 23, 2026
Request FieldsErrors
On this page
  • Data object
  • Score values
JSON