Phone API
Unlock insights into a user's phone number's history and find social or digital profiles connected to it.
Good to know
- Use the Fraud API if you want to use the Phone API together 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.
Request
Optional query string parameters
In order to request additional or receive less information, use the following parameters in the request URL as in the example below:
Request Attributes | Value | Required | |
---|---|---|---|
include | history | no | |
include | flags | no | |
include | id | no | |
include | cnam_lookup | no | |
include | hlr_details | no | |
flags_timeframe_days | [number of days] | no | |
exclude | photo | no | |
exclude | last_seen | no | |
timeout | [number of milliseconds] | no | |
HTTP Endpoint
PHP
Generic
Generic
Response
The endpoint returns JSON structured response.
JSON Attributes | Type | |
---|---|---|
number | integer | |
valid | boolean | |
disposable | boolean | |
type | string | |
country | string | |
carrier | string | |
score | number | |
account_details | object | |
applied_rules | array of object | |
hlr_details | object | |
cnam_details | object | |
history | object | |
flags | array of object | |
id | string | |