For Non-Truecaller users verification flow

Once the SDK shares the accessToken for any user verified via drop call / OTP based verificaiton flow, you can verify the authenticity of the access token by making API call from your server to Truecaller's server. The following endpoint will return phone number and country code for the given access token.

API Endpoint:

"https://api4.truecaller.com/v1/otp/installation/phoneNumberDetail/{accessToken}"

REQUEST :

Method : GET

Header Parameters:

Parameter Name

Required

Description

Example

appKey

yes

App Key ( Partner Key )

zHTqS70ca9d3e988946f19a65a01dRR5e56460

Request Path Parameters:

Parameter Name

Required

Description

Example

accessToken

yes

token granted for the partner for the respective user number that initiated login

"71d8367e-39f7-4de5-a3a3-2066431b9ca8"

RESPONSE:

  • 200 OK - If access token is valid

{
"phoneNumber":919999XXXXX9
"countryCode":"IN"
}
  • 404 Not Found - If your credentials are not valid

{
"code":404
"message":"Invalid partner credentials."
}
  • 404 Not Found - If access token is invalid

{
"code":1404
"message":"Invalid access token."
}
  • 500 Internal Error - for any other internal error

{
"code":500
"message":"error message"
}