APIv3 Device Calls

List Models

/apiv3/device/models/{vendor}.json

Provide a list of models for any given vendor. Useful for populating dropdown boxes and select lists after the vendor has been selected. Parameters : headers. Returns : message, status plus a list of all device models for this vendor sorted alphabetically.

Example Command

curl -u "api-username:api-secret" --digest http://api.handsetdetection.com/apiv3/device/models/Sagem.json

Example Reply (truncated)

{
    "message" : "OK",
    "status" : "0",
    "model" : [
        "3000",
        "3016",
        "3XXX",
        "910",
        "912",
        "916",
        "919",
        "920",
        "922",
        "926",
        "929",
        "930",
        "932",
        "936",
        "939",
        "940",
        "942",
        "946"
    ]
}

##List Vendors

/apiv3/device/vendors.json

Provide a list of vendors for all devices in our system. Useful for populating dropdown boxes and select lists. Parameters : headers. Returns message, status plus a list of all vendors sorted alphabetically.

Example Command

curl -u "api-username:api-secret" --digest http://api.handsetdetection.com/apiv3/device/vendors.json

Example Reply (truncated)

{
    "message" : "OK",
    "status" : "0",
    "vendor" : [
        "Access",
        "Acer",
        "Aiko",
        "Airness",
        "Alcatel",
        "AlphaCell Wireless",
        "Amazon",
        "Amoi",
        "Amoisonic",
        "Android",
        "AnexTek",
        "Apple",
        "ARCELIK"
    ]
}

View Details

/apiv3/device/view/{vendor}/{model}.json

Provide handset information for a given vendor/model. Useful for populating dropdown boxes and select lists after the vendor has been selected. Parameters : headers. Returns : message, status plus a list of all device models for this vendor sorted alphabetically.

Example Command

curl -u "api-username:api-secret" --digest http://api.handsetdetection.com/apiv3/device/view/Nokia/N95.json

Example Reply

{"device":
    {"general_vendor":"Nokia",
    "general_model":"N95",
    "general_platform":"Symbian OS",
    "general_image":"nokia^n95.gif",
    "general_aliases":[],
    "general_eusar":"0.50",
    "general_battery":["Li-Ion 950 mAh","BL-5F"],
    "general_type":"Mobile",
    "general_cpu":["Dual ARM 11","332Mhz"],
    "design_formfactor":"Dual Slider",
    "design_dimensions":"99 x 53 x 21",
    "design_weight":"120",
    "design_antenna":"Internal",
    "design_keyboard":"Numeric",
    "design_softkeys":"2",
    "design_sidekeys":["Camera","Media","Volume"],
    "display_type":"TFT",
    "display_color":"Yes",
    "display_colors":"16M",
    "display_size":"2.6\"",
    "display_x":"240",
    "display_y":"320",
    "display_other":[],
    "memory_internal":["160MB","64MB RAM","256MB ROM"],
    "memory_slot":["MicroSD","8GB"],
    "network":["GSM 850","GSM 900","GSM 1800","GSM 1900","HSDPA 2100","HSDPA 850","HSDPA 1900","802.11b","802.11g","Infrared Port","GPRS Class 10","EDGE Class 32"],
    "media_camera":["5 MP","2592 x 1944"],
    "media_secondcamera":["QVGA videocall camera"],
    "media_videocapture":["VGA@30fps"],
    "media_videoplayback":["WMV","RV","MP4","3GP"],
    "media_audio":["MP3","WMA","WAV","RA","AAC","M4A"],
    "media_other":["autofocus","LED flash"],
    "features":["Organizer","Document viewer (Word","Excel","PowerPoint","PDF)","Predictive text input","Push to talk","Voice dial","Voice memo","Java MIDP 2.0","Internet Browsing HTML","XHTML","WAP 2.0","Flash Lite (2.0)","Unlimited entries","Multiple numbers per contact","Picture ID","Ring ID","Calendar","Alarm","To-Do","Document viewer","Calculator","Notes","SMS","MMS (T9)","Email","IMAP","POP3","SMTP","Games Downloadable","Instant Messaging","Advanced Audio Distribution (A2DP)","Audio\/Visual Remote Control Profile (AVRCP)","Basic Imaging (BIP)","Basic Printing (BPP)","Dial-up networking (DUN)","File Transfer (FTP)","Generic Audio\/Video Distribution (GAVDP)","Generic Object Exchange (GOEP)","Handsfree (HFP)","Headset (HSP)","Object Push (OPP)","SIM Access (SAP)","Music ringtones (MP3)","Vibration","Phone profiles","Speakerphone","Accelerometer","Voice dialing","Voice commands","Voice recording","Push-to-Talk"],
    "connectors":["TV-Out","miniUSB","3.5mm jack"]}
}

WhatHas

/apiv3/device/whathas/{property}/{value}.json

Provide information for devices that support a given property. Parameters : headers. Returns : message, status plus a list of all device models sorted by id.

Example Command

What devices have CDMA in their network property ?

curl -u "api-username:api-secret" --digest http://api.handsetdetection.com/apiv3/device/whathas/network/CDMA.json

Example Reply (truncated)

{"devices":[
    {"id":"10","general_vendor":"Samsung","general_model":"VM-A680 (SPH-A680)"},
    {"id":"1003","general_vendor":"LG","general_model":"CU6060"},
    {"id":"1020","general_vendor":"Nokia","general_model":"2270"},
    {"id":"1048","general_vendor":"Sanyo","general_model":"SCP 6200"},
    {"id":"1049","general_vendor":"Sanyo","general_model":"SCP6000"},
    {"id":"1050","general_vendor":"LG","general_model":"MX9700"},
    {"id":"1054","general_vendor":"Spice","general_model":"D-88"},
    ...

Get Started Today

Our free Express / Cloud plan has 20,000 detections per month. No credit card required. Upgrade when you're ready. We also have a free Community Edition for Ultimate Detection, our high performance local detection library, which you can build into community open source projects.


Get Started. Its Free