Phone Footprint

API Description

The Phone Footprint API takes a mobile phone number as input and returns a list of online platforms and services where the phone number is likely registered. This serves as an indicator of the phone number's digital presence and legitimacy during customer onboarding and risk assessment.

Traditional phone verification solutions only validate whether a phone number is active or reachable. However, organizations often require additional signals to assess trustworthiness and reduce onboarding risk. The Phone Footprint API provides a privacy-compliant way to identify the digital footprint of a phone number across multiple online platforms, helping organizations evaluate credibility and detect potential fraud.

API cURL

Production

curl --location 'https://api.signzy.app/api/v3/phone-footprint' \ --header 'Authorization: XXXXX' \ --header 'Content-Type: application/json' \ --data-raw '{ "phone": "xxxx" }'

Pre-Production

curl --location 'https://api-preproduction.signzy.app/api/v3/phone-footprint' \ --header 'Authorization: XXXXX' \ --header 'Content-Type: application/json' \ --data-raw '{ "phone": "xxxx" }'

Input Table

Parameter	Required	Type
phone	Yes	String

API Output

JSON

{ "result": { "accountDetails": { "toi": false, "swiggy": true, "flipkart": true, "housing": true, "gaana": false, "indianexpress": false, "twitter": false, "whatsapp": true, "shaadi": false, "instagram": true, "jeevansathi": false, "facebook": false, "oyorooms": false, "samsung": false }, "socialProfileCount": "5" }, "reason": "Request Successful", "code": "S001" }

Response Table

Field	Type	Description
result	Object	Contains the footprint information associated with the phone number.
result.accountDetails	Object	Indicates whether the phone number is registered on supported platforms.
result.accountDetails.toi	Boolean	Registration status on Times of India.
result.accountDetails.swiggy	Boolean	Registration status on Swiggy.
result.accountDetails.flipkart	Boolean	Registration status on Flipkart.
result.accountDetails.housing	Boolean	Registration status on Housing.com.
result.accountDetails.gaana	Boolean	Registration status on Gaana.
result.accountDetails.indianexpress	Boolean	Registration status on Indian Express.
result.accountDetails.twitter	Boolean	Registration status on Twitter/X.
result.accountDetails.whatsapp	Boolean	Registration status on WhatsApp.
result.accountDetails.shaadi	Boolean	Registration status on Shaadi.com.
result.accountDetails.instagram	Boolean	Registration status on Instagram.
result.accountDetails.jeevansathi	Boolean	Registration status on Jeevansathi.
result.accountDetails.facebook	Boolean	Registration status on Facebook.
result.accountDetails.oyorooms	Boolean	Registration status on OYO Rooms.
result.accountDetails.samsung	Boolean	Registration status on Samsung.
result.socialProfileCount	String	Total number of platforms where the phone number is detected.
reason	String	API response message.
code	String	Internal response code.

Success Codes

HTTP Status Code	Success Code	Description
200	S001	Request Successful

Error Codes

HTTP Status Code	Description
400	Bad Request. Invalid input data
409	Upstream Error