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.
You can unlock additional profile details for in-depth fraud investigations into a user’s digital footprint. Please note that these signals do not support high load and low latency use cases and are disabled by default. To learn more, please reach out to support@seon.io.

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/v1/[phone_number]

Request

Warning: The [phone_number] in the request URL should include the full phone number only including country code without additional formatting. Cannot contain spaces or hyphens, only optionally the + sign for the country code. The maximum length is 19 characters for the [phone_number]. Required format: 36301234567 or +36301234567.

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	Type	Required
version	string	yes

include	string	no

exclude	string	no

flags_timeframe_days	integer	no

timeout	integer	no

priority_timeout	integer	no

priority_sites	string	no

HTTP Endpoint

GET

https://api.seon.io/SeonRestService/phone-api/v1/[phone_number]

Language

Industry

Use case

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": true
   },
   "google": {
    "registered": false,
    "account_id": null,
    "full_name": null
   },
   "twitter": {
    "registered": true
   },
   "instagram": {
    "registered": false
   },
   "yahoo": {
    "registered": null
   },
   "microsoft": {
    "registered": true
   },
   "snapchat": {
    "registered": null
   },
   "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": true,
    "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": true,
    "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": true
   },
   "jdid": {
    "registered": null
   },
   "altbalaji": {
    "registered": false
   },
   "shopclues": {
    "registered": true
   },
   "snapdeal": {
    "registered": null
   },
   "tiki": {
    "registered": true
   },
   "vkontakte": {
    "registered": false
   },
   "weibo": {
    "registered": true
   }
  },
  "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
 }
}

Phone API

Good to know

Request

Optional query string parameters

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

version

include

exclude

flags_timeframe_days

timeout

priority_timeout

priority_sites

HTTP Endpoint

GET

https://api.seon.io/SeonRestService/phone-api/v1/[phone_number]

Response

JSON Attributes

number

valid

disposable

type

country

carrier

score

account_details

applied_rules

hlr_details

cnam_details

history

flags

id

Response