SEON user docs logoSEON user docs logoSEON user docs logo
Search input icon

Phone API

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. Learn more about SEON's network models here.

Request

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

Request Attributes

TypeRequired
phone
stringyes
config
objectno

HTTP Endpoint

POST

https://api.seon.io/SeonRestService/phone-api/v2
Python
Generic
Generic

Response

The endpoint returns a JSON-structured response.

JSON Attributes

 Type
id
 string
phone
 string
risk_scores
 object
account_aggregates
 object
seon_fraud_history
 object
provider_carrier_details
 object
hlr_details
 object
cnam_details
 object
Response
{
 "success": true,
 "error": {},
 "data": {
  "id": "9c02924f-9fa0-432c-9f0b-9a12873870b7",
  "phone": 36301234567,
  "risk_scores": {
   "global_network_score": 67.62
  },
  "account_aggregates": {
   "total_registration": 12,
   "business": {
    "total_registration": 5,
    "technology": {
     "registered": 2,
     "checked": 1
    },
    "science_and_education": {
     "registered": 0,
     "checked": 1
    },
    "jobs_and_employment": {
     "registered": 1,
     "checked": 0
    },
    "money_transfer_remittance": {
     "registered": 2,
     "checked": 4
    }
   },
   "personal": {
    "total_registration": 7,
    "email_service": {
     "registered": 1,
     "checked": 1
    },
    "messenger": {
     "registered": 1,
     "checked": 3
    },
    "technology": {
     "registered": 0,
     "checked": 3
    },
    "delivery": {
     "registered": 1,
     "checked": 1
    },
    "ecommerce": {
     "registered": 2,
     "checked": 6
    },
    "entertainment": {
     "registered": 0,
     "checked": 3
    },
    "social_media": {
     "registered": 1,
     "checked": 9
    },
    "travel": {
     "registered": 1,
     "checked": 1
    }
   }
  },
  "seon_fraud_history": {
   "fraudulent_decline_first_seen": 1625384237,
   "fraudulent_decline_last_seen": 1713949826,
   "fraudulent_decline_customer_hits": 2,
   "fraudulent_decline_hits": 2,
   "first_seen": 1584887689,
   "last_seen": 1713949826,
   "customer_hits": 4,
   "hits": 9,
   "flags": []
  },
  "provider_carrier_details": {
   "carrier": "Verizon Ltd",
   "country": "US",
   "disposable": false,
   "phone_is_valid": true,
   "type": "MOBILE"
  },
  "hlr_details": {
   "imsi": "316000000000000",
   "original_carrier": {
    "carrier": "Verizon Wireless",
    "carrier_prefix": "212333"
   },
   "ported_carrier": {
    "carrier": "USA - Landline and Other Carriers",
    "carrier_prefix": "252271"
   },
   "roaming_carrier": {
    "carrier": null,
    "carrier_prefix": null,
    "carrier_country": null
   },
   "serving_msc": null,
   "status": "delivered"
  },
  "cnam_details": {
   "name": "John Doe"
  }
 }
}

Fraud API Integration

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