Server Side Validation

Once the SDK shares the accessToken for any user verified via drop call based verification 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://sdk-otp-verification-noneu.truecaller.com/v1/otp/client/installation/phoneNumberDetail/{accessToken}"

REQUEST :

Method : GET

Header Parameters:

Parameter Name	Required	Description	Example
clientId	yes	Client ID	zHTqS70ca9d3e016946f19a65b01dRR5e56460

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"
}