Phone API v2

Our standalone Phone API is designed to provide invaluable insights into the digital footprint associated with a phone number, such as its carrier, whether it is disposable, and the number of online profiles found when checking on more than 30 digital sites. It also returns SEON's consortium fraud history built on our global intelligence for millions of onboarding events and a proprietary network score, which can be used as a new indicator of confidence when assessing a user’s digital profile. The risk score leverages machine learning alongside consortium data from over 5,000 customers. Risk scores are derived from an anonymized model trained on historical data dating back 6 years, ensuring precise and accurate risk assessments.

Good to know

• Use the Fraud API if you want to utilize SEON’s scoring engine for rule evaluation.
• Use the Fraud API if you want to use the Phone API together with any of our Email API, IP API, and Device Fingerprinting.
• All SEON API requests are case-sensitive. Please follow the formatting below to avoid errors.
• Phone API requests are limited to 120/minute during your SEON free trial.
• Consider using a higher, 4-5 seconds timeout setting for better data coverage.
• Using the proprietary network scores and aggregated signals eliminates the need to manage and tune individual signals, which will free up resources. Additionally, future signals will be automatically added to this new version, requiring no additional development work.
• The consortium-based threat intelligence pools data from diverse sectors and geographies for comprehensive threat detection. Consortium data from SEON’s proprietary network is available in two ways:
  • It is incorporated into the email and phone network risk scores;
  • There is a new section within Email module called the SEON Fraud History where fraudulent transaction history is returned.
• You can improve the accuracy of the network score by labeling data via the Label API or adjusting transaction states on the Admin Panel. Labels help the model learn from past fraudulent activities and update itself regularly for better accuracy.

If you are using our US Transaction Processing Environment please use the correct endpoint: https://api.us-east-1-main.seon.io/SeonRestService/phone-api/v2

Add the following parameters to the request URL for more control over the returned data, as seen in the example.

Request Attributes	Type	Required	Expand all
phone	string	yes
config	object	no

The endpoint returns a JSON-structured response.

JSON Attributes		Type	Expand all
id		string
phone		string
risk_scores		object
account_aggregates		object
seon_fraud_history		object
provider_carrier_details		object
hlr_details		object
cnam_details		object

To enable Advanced Digital Footprint, configure the newest Email API (v3) and Phone API (v2) versions under Fraud API config.

Do you have any questions?

Contact us