Device Info Add-on

The Device Info add-on allows you to provide an end-user phone number and receive its phone manufacturer and model to detect fraud or understand the value or risk of the device holder and adjust content and marketing strategies per device.

Device Info for Switzerland

If you are using Device Info for Switzerland, the following rules apply:

  • The fields you can get back for Switzerland (Swisscom only) phone numbers are:
    • imei
    • make
    • model

Example Request and Response for Device Info

POST Request for Device Info
POST https://rest-ww.telesign.com/v1/phoneid/15555551212 HTTP/1.1
Authorization: Basic 12345678-9ABC-DEF0-1234-56789ABCDEF0:vjE/ZDfPvDkuGNsuqCFFO4neYIs=
Date: Thu, 12 Oct 2017 14:11:09 GMT
Content-Type: application/json 

{  
		“addons”: {
 			“device_info”: {}
		}
}
Device Info Response Body
{
  "device_info": {
    "make": "APPLE",
    "model": "A1784",
    "imei": "355376084044028",
    "status": {
      "code": 2800,
      "description": "Request successfully completed"
    }
  }
}
Device Info Request Parameters
object
addons
object

You must have you Technical Account Manager enable this feature for use. The addons parameter allows you to receive information returned from Contact, Contact Plus, Contact Match, or Number Deactivation, depending on which add-ons you enable. You receive add-on information back along with standard PhoneID information.

Device Info Response
object
reference_id
string

A 32-digit hex value used to identify the web service requests. The value is unique to each web service request, is randomly generated by TeleSign, and is returned in the response message immediately following the web service request.

phone_type
string

One of the phone type codes.

description
string

Text describing the phone type.

device_info
object

You will only see this in your response if you used the device info add-on.