v2 API - Devices Detectall (deprecated)

Detect all devices

API v2.0 - /devices/detectall

Purpose Detect a Mobile, Tablet or Console. Can also perform a geoip look up. Usually a detection is called at the start of a session.
XML URI /devices/detectall.xml
JSON URI /devices/detectall.json
Parameters headersoptionsa request
Returns messagestatus, class (Mobile, Console, Tablet, Unknown), plus option information for this device, or no information if this device cannot be found.

Note: class is only set if there are no errors. Discussion : The thorny legacy issueWe wanted to add the ability to detect iPads and Consoles. Problem is there is an expectation that the detect api call only provides information about handsets and when it cant provide information about a handset it returns ‘Not Found’. Not Found means its most likely a browser. If detect suddenly started returning iPad or Console information we might break some folks websites that expect ‘Not Found’ to mean not mobile – and we didnt want that. So, we find ourselves with detectall. Our new workhorse for detections. detectall returns the same information as the detect call you’ve come to know and love accept it has an added class field which returns Unknown for unknown browser, Mobile for cell phone, Tablet for tablet devices (iPads and such) and Console for games consoles.

XML Example Request

<?xml version='1.0'?>
<request>
    <options>geoip, product_info, display</options>
    <User-Agent>Mozilla/5.0 (SymbianOS/9.2; U; Series60/3.1 NokiaN95/12.0.013; Profile/MIDP-2.0 Configuration/CLDC-1.1 ) AppleWebKit/413 (KHTML, like Gecko) Safari/413</User-Agent>
    <x-wap-profile>http://nds1.nds.nokia.com/uaprof/NN95-1r100.xml</x-wap-profile>
    <site>38</site>
</request>

XML Example Reply

<xml version="1.0" encoding="UTF-8" ?>
<reply>
    <message>OK</message>
    <status>0</status>
    <class>Mobile</class>
    <geoip>
        <country>France</country>
        <city>Arcueil</city>
        <countrycode>FR</countrycode>
        <region>A8</region>
        <latitude>48.8</latitude>
        <longitude>2.3333</longitude>
        <isp></isp>
        <company></company>
    </geoip>
    <product_info>
        <brand_name>Nokia</brand_name>
        <model_name>N95</model_name>
        <unique>1</unique>
        <ununiqueness_handler></ununiqueness_handler>
        <is_wireless_device>1</is_wireless_device>
        <device_claims_web_support>1</device_claims_web_support>
        <has_pointing_device>1</has_pointing_device>
        <has_qwerty_keyboard></has_qwerty_keyboard>
        <can_skip_aligned_link_row>1</can_skip_aligned_link_row>
        <uaprof>http://nds1.nds.nokia.com/uaprof/NN95-1r100.xml</uaprof>
        <uaprof2></uaprof2>
        <uaprof3></uaprof3>
        <nokia_series>60</nokia_series>
        <nokia_edition>3</nokia_edition>
        <device_os>Symbian OS</device_os>
        <mobile_browser>Nokia</mobile_browser>
        <mobile_browser_version></mobile_browser_version>
    </product_info>
    <display>
        <resolution_width>240</resolution_width>
        <resolution_height>320</resolution_height>
        <columns>15</columns>
        <max_image_width>240</max_image_width>
        <max_image_height>280</max_image_height>
        <rows>6</rows>
    </display>
</reply>

JSON Example Request

{
    "User-Agent" : "Amoi-A310\/Plat-F-VIM\/WAP2.0\/MIDP1.0\/CLDC1.0 UP.Browser\/6.2.2.7.c.1.102 (GUI) MMP\/1.0",
    "options" : "chtml_ui,xhtml_ui,cache,image_format,security,bearer,storage,object_download,drm,mms,j2me,flash_lite",
    "site" : "38"
}

JSON Example Reply

{
    "message" : "OK",
    "status" : "0",
    "class" : "Mobile",
    "chtml_ui" :
    {
        "chtml_display_accesskey" : false,
        "emoji" : false,
        "chtml_can_display_images_and_text_on_same_line" : false,
        "chtml_displays_image_in_center" : false,
        "imode_region" : "none",
        "chtml_make_phone_call_string" : "tel:",
        "chtml_table_support" : false
    },
    "xhtml_ui" : 
    {
        "xhtml_honors_bgcolor" : false,
        "xhtml_supports_forms_in_table" : false,
        "xhtml_support_wml2_namespace" : false,
        "xhtml_autoexpand_select" : true,
        "xhtml_select_as_dropdown" : false,
        "xhtml_select_as_radiobutton" : false,
        "xhtml_select_as_popup" : false,
        "xhtml_display_accesskey" : false,
        "xhtml_supports_invisible_text" : true,
        "xhtml_supports_inline_input" : true,
        "xhtml_supports_monospace_font" : true,
        "xhtml_supports_table_for_layout" : true,
        "xhtml_supports_css_cell_table_coloring" : true,
        "xhtml_format_as_css_property" : true,
        "xhtml_format_as_attribute" : true,
        "xhtml_nowrap_mode" : true,
        "xhtml_marquee_as_css_property" : true,
        "xhtml_readable_background_color1" : "#99CCFF",
        "xhtml_readable_background_color2" : "#FFFFFF",
        "xhtml_allows_disabled_form_elements" : true,
        "xhtml_document_title_support" : true,
        "xhtml_preferred_charset" : "iso8859",
        "opwv_xhtml_extensions_support" : true,
        "xhtml_make_phone_call_string" : "wtai:\/\/wp\/mc;",
        "xhtmlmp_preferred_mime_type" : "text\/html",
        "xhtml_table_support" : true,
        "xhtml_send_sms_string" : "none",
        "xhtml_send_mms_string" : "none",
        "xhtml_supports_file_upload" : false,
        "xhtml_file_upload" : "supported"
    },
    "cache" : 
    {
        "total_cache_disable_support" : false,
        "time_to_live_support" : false
    },
    "image_format" : 
    {
        "wbmp" : true,
        "bmp" : false,
        "epoc_bmp" : false,
        "gif_animated" : false,
        "jpg" : true,
        "png" : true,
        "tiff" : false,
        "transparent_png_alpha" : false,
        "transparent_png_index" : false,
        "svgt_1_1" : false,
        "svgt_1_1_plus" : false,
        "greyscale" : false,
        "gif" : true,
        "colors" : 256
    },
    "security" : 
    {
        "https_support" : true,
        "https_detectable" : false,
        "phone_id_provided":false
    },
    "bearer" : 
    {
        "max_data_rate":9,
        "wifi":false
    },
    "storage" : 
    {
        "max_deck_size":4096,
        "max_url_length_in_requests":0,
        "max_url_length_homepage":0,
        "max_url_length_bookmark":0,
        "max_url_length_cached_page":0,
        "max_no_of_connection_settings":0,
        "max_no_of_bookmarks":0,
        "max_length_of_username":0,
        "max_length_of_password":0,
        "max_object_size":0
    },
    "object_download" : 
    {
        "downloadfun_support" : false,
        "directdownload_support" : false,
        "inline_support" : false,
        "oma_support" : true,
        "ringtone" : false,
        "ringtone_3gpp" : false,
        "ringtone_midi_monophonic" : false,
        "ringtone_midi_polyphonic" : false,
        "ringtone_imelody" : false,
        "ringtone_digiplug" : false,
        "ringtone_compactmidi" : false,
        "ringtone_mmf" : false,
        "ringtone_rmf" : false,
        "ringtone_xmf" : false,
        "ringtone_amr" : false,
        "ringtone_awb" : false,
        "ringtone_aac" : false,
        "ringtone_wav" : false,
        "ringtone_mp3" : false,
        "ringtone_spmidi" : false,
        "ringtone_qcelp" : false,
        "ringtone_voices" : 1,
        "ringtone_df_size_limit" : 0,
        "ringtone_directdownload_size_limit" : 0,
        "ringtone_inline_size_limit" : 0,
        "ringtone_oma_size_limit" : 0,
        "wallpaper" : false,
        "wallpaper_max_width" : 0,
        "wallpaper_max_height" : 0,
        "wallpaper_preferred_width" : 0,
        "wallpaper_preferred_height" : 0,
        "wallpaper_resize" : "none",
        "wallpaper_wbmp" : false,
        "wallpaper_bmp" : false,
        "wallpaper_gif" : false,
        "wallpaper_jpg" : false,
        "wallpaper_png" : false,
        "wallpaper_tiff" : false,
        "wallpaper_greyscale" : false,
        "wallpaper_colors" : 2,
        "wallpaper_df_size_limit" : 0,
        "wallpaper_directdownload_size_limit" : 0,
        "wallpaper_inline_size_limit" : 0,
        "wallpaper_oma_size_limit" : 0,
        "screensaver" : false,
        "screensaver_max_width" : 0,
        "screensaver_max_height" : 0,
        "screensaver_preferred_width" : 0,
        "screensaver_preferred_height" : 0,
        "screensaver_resize" : "none",
        "screensaver_wbmp" : false,
        "screensaver_bmp" : false,
        "screensaver_gif" : false,
        "screensaver_jpg" : false,
        "screensaver_png" : false,
        "screensaver_greyscale" : false,
        "screensaver_colors" : 2,
        "screensaver_df_size_limit" : 0,
        "screensaver_directdownload_size_limit" : 0,
        "screensaver_inline_size_limit" : 0,
        "screensaver_oma_size_limit" : 0,
        "picture" : false,
        "picture_max_width" : 0,
        "picture_max_height" : 0,
        "picture_preferred_width" : 0,
        "picture_preferred_height" : 0,
        "picture_resize" : "none",
        "picture_wbmp" : false,
        "picture_bmp" : false,
        "picture_gif" : false,
        "picture_jpg" : false,
        "picture_png" : false,
        "picture_greyscale" : false,
        "picture_colors" : 2,
        "picture_df_size_limit" : 0,
        "picture_directdownload_size_limit" : 0,
        "picture_inline_size_limit" : 0,
        "picture_oma_size_limit" : 0,
        "video" : false,
        "video_real_media_8" : false,
        "video_real_media_9" : false,
        "video_real_media_10" : false,
        "video_3gpp" : false,
        "video_3gpp2" : false,
        "video_mp4" : false,
        "video_wmv" : false,
        "video_mov" : false,
        "video_max_frame_rate" : 0,
        "video_max_width" : 0,
        "video_max_height" : 0,
        "video_qcif" : false,
        "video_sqcif" : false,
        "video_preferred_width" : 0,
        "video_preferred_height" : 0,
        "video_df_size_limit" : 0,
        "video_directdownload_size_limit" : 0,
        "video_inline_size_limit" : 0,
        "video_oma_size_limit" : 0,
        "video_vcodec_h263_0" : false,
        "video_vcodec_h263_3" : false,
        "video_vcodec_h264" : "none",
        "video_vcodec_mpeg4" : false,
        "video_acodec_amr" : false,
        "video_acodec_awb" : false,
        "video_acodec_aac" : false,
        "video_acodec_aac_ltp" : false,
        "video_acodec_qcelp" : false
    },
    "drm" : 
    {
        "oma_v_1_0_forwardlock" : true,
        "oma_v_1_0_combined_delivery" : false,
        "oma_v_1_0_separate_delivery" : false
    },
    "mms" : 
    {
        "receiver" : false,
        "sender" : false,
        "mms_max_size" : 0,
        "mms_max_height" : 0,
        "mms_max_width" : 0,
        "built_in_recorder" : false,
        "built_in_camera" : false,
        "mms_jpeg_baseline" : false,
        "mms_jpeg_progressive" : false,
        "mms_gif_static" : false,
        "mms_gif_animated" : false,
        "mms_png" : false,
        "mms_bmp" : false,
        "mms_wbmp" : false,
        "mms_amr" : false,
        "mms_wav" : false,
        "mms_midi_monophonic" : false,
        "mms_midi_polyphonic" : false,
        "mms_midi_polyphonic_voices" : 0,
        "mms_spmidi" : false,
        "mms_mmf" : false,
        "mms_mp3" : false,
        "mms_evrc" : false,
        "mms_qcelp" : false,
        "mms_ota_bitmap" : false,
        "mms_nokia_wallpaper" : false,
        "mms_nokia_operatorlogo" : false,
        "mms_nokia_3dscreensaver" : false,
        "mms_nokia_ringingtone" : false,
        "mms_rmf" : false,
        "mms_xmf" : false,
        "mms_symbian_install" : false,
        "mms_jar" : false,
        "mms_jad" : false,
        "mms_vcard" : false,
        "mms_vcalendar" : false,
        "mms_wml" : false,
        "mms_wbxml" : false,
        "mms_wmlc" : false,
        "mms_video" : false,
        "mms_mp4" : false,
        "mms_3gpp" : false,
        "mms_3gpp2" : false,
        "mms_max_frame_rate" : 0
    },
    "j2me" : 
    {
        "j2me_cldc_1_0" : false,
        "j2me_cldc_1_1" : false,
        "j2me_midp_1_0" : false,
        "j2me_midp_2_0" : false,
        "doja_1_0" : false,
        "doja_1_5" : false,
        "doja_2_0" : false,
        "doja_2_1" : false,
        "doja_2_2" : false,
        "doja_3_0" : false,
        "doja_3_5" : false,
        "doja_4_0" : false,
        "j2me_jtwi" : false,
        "j2me_mmapi_1_0" : false,
        "j2me_mmapi_1_1" : false,
        "j2me_wmapi_1_0" : false,
        "j2me_wmapi_1_1" : false,
        "j2me_wmapi_2_0" : false,
        "j2me_btapi" : false,
        "j2me_3dapi" : false,
        "j2me_loctapi" : false,
        "j2me_nokia_ui" : false,
        "j2me_motorola_lwt" : false,
        "j2me_siemens_color_game" : false,
        "j2me_siemens_extension" : false,
        "j2me_heap_size" : 0,
        "j2me_max_jar_size" : 0,
        "j2me_storage_size" : 0,
        "j2me_max_record_store_size" : 0,
        "j2me_screen_width" : 0,
        "j2me_screen_height" : 0,
        "j2me_canvas_width" : 0,
        "j2me_canvas_height" : 0,
        "j2me_bits_per_pixel" : 0,
        "j2me_audio_capture_enabled" : false,
        "j2me_video_capture_enabled" : false,
        "j2me_photo_capture_enabled" : false,
        "j2me_capture_image_formats" : "none",
        "j2me_http" : false,
        "j2me_https" : false,
        "j2me_socket" : false,
        "j2me_udp" : false,
        "j2me_serial" : false,
        "j2me_gif" : false,
        "j2me_gif89a" : false,
        "j2me_jpg" : false,
        "j2me_png" : false,
        "j2me_bmp" : false,
        "j2me_bmp3" : false,
        "j2me_wbmp" : false,
        "j2me_midi" : false,
        "j2me_wav" : false,
        "j2me_amr" : false,
        "j2me_mp3" : false,
        "j2me_mp4" : false,
        "j2me_imelody" : false,
        "j2me_rmf" : false,
        "j2me_au" : false,
        "j2me_aac" : false,
        "j2me_realaudio" : false,
        "j2me_xmf" : false,
        "j2me_wma" : false,
        "j2me_3gpp" : false,
        "j2me_h263" : false,
        "j2me_svgt" : false,
        "j2me_mpeg4" : false,
        "j2me_realvideo" : false,
        "j2me_real8" : false,
        "j2me_realmedia" : false,
        "j2me_left_softkey_code" : 0,
        "j2me_right_softkey_code" : 0,
        "j2me_middle_softkey_code" : 0,
        "j2me_select_key_code" : 0,
        "j2me_return_key_code" : 0,
        "j2me_clear_key_code" : 0,
        "j2me_datefield_no_accepts_null_date" : false,
        "j2me_datefield_broken" : false
    },
    "flash_lite" : 
    {
        "flash_lite_version" : "",
        "fl_wallpaper" : false,
        "fl_screensaver" : false,
        "fl_standalone" : false,
        "fl_browser" : false,
        "fl_sub_lcd" : false
    }
}

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