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

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.
  • For in-depth fraud investigations, or situations where additional profile information is necessary and a higher timeout setting can be accommodated, use detailed Data Enrichment Mode. More information can be found below under Request Attributes.

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:

GET

https://api.seon.io/SeonRestService/phone-api/v1/[phone_number]?include=history,flags,id&flags_timeframe_days=10&exclude=photo,last_seen&timeout=5000

Request Attributes

TypeRequired
version
stringyes
include
stringno
exclude
stringno
flags_timeframe_days
integerno
timeout
integerno
priority_timeout
integerno
priority_sites
stringno
priority_accuracy
numberno
data_enrichment_mode
stringno

HTTP Endpoint

GET

https://api.seon.io/SeonRestService/phone-api/v1/[phone_number]
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
Response
{
 "success": true,
 "error": {},
 "data": {
  "number": 36200130525,
  "valid": true,
  "disposable": false,
  "type": "mobile",
  "country": "HU",
  "carrier": "Yettel Hungary",
  "score": 4,
  "account_details": {
   "facebook": {
    "registered": false
   },
   "google": {
    "registered": false,
    "account_id": null,
    "full_name": null
   },
   "twitter": {
    "registered": false
   },
   "instagram": {
    "registered": false
   },
   "yahoo": {
    "registered": null
   },
   "microsoft": {
    "registered": false
   },
   "snapchat": {
    "registered": false
   },
   "skype": {
    "registered": false,
    "age": null,
    "city": null,
    "bio": null,
    "country": null,
    "gender": null,
    "language": null,
    "name": null,
    "handle": null,
    "id": null,
    "photo": null,
    "state": null
   },
   "whatsapp": {
    "registered": false,
    "photo": null,
    "last_seen": null,
    "about": null,
    "last_active": null
   },
   "telegram": {
    "registered": null,
    "photo": null,
    "last_seen": null
   },
   "viber": {
    "registered": null,
    "photo": null,
    "last_seen": null,
    "name": null
   },
   "kakao": {
    "registered": null
   },
   "ok": {
    "registered": false,
    "age": null
   },
   "zalo": {
    "registered": false,
    "date_of_birth": null,
    "name": null,
    "uid": null
   },
   "line": {
    "registered": null,
    "name": null,
    "photo": null
   },
   "flipkart": {
    "registered": false
   },
   "bukalapak": {
    "registered": false
   },
   "jdid": {
    "registered": null
   },
   "altbalaji": {
    "registered": false
   },
   "shopclues": {
    "registered": false
   },
   "snapdeal": {
    "registered": null
   },
   "tiki": {
    "registered": false
   },
   "vkontakte": {
    "registered": false
   },
   "weibo": {
    "registered": false
   }
  },
  "applied_rules": [
   {
    "id": "PH102",
    "name": "No online profiles were found",
    "operation": "+",
    "score": 4
   }
  ],
  "id": "c9dcf2ce-9a85-4d16-8761-fce122e682fc",
  "history": {
   "hits": 173,
   "customer_hits": 8,
   "first_seen": 1653484836,
   "last_seen": 1698248016
  },
  "flags": [],
  "hlr_details": {
   "imsi": "216010000000000",
   "original_carrier": {
    "carrier": null,
    "carrier_prefix": "20"
   },
   "ported_carrier": null,
   "roaming_carrier": null,
   "serving_msc": null,
   "status": "delivered"
  },
  "cnam_details": null
 }
}