Sign up below to view device data and get your trial account.

We communicate via email to process your request in line with our privacy policy. Please check the box to give us your permission to do this.



REST API & Data Dictionary


DeviceAtlas provides a REST API for fetching definitions of pre-defined property values (data dictionary) and for sending device/User-Agent data to DeviceAtlas.

URI structure

All DeviceAtlas requests start with prefix. The following parts of the path depend on the endpoint of the request.

For example, the following shows cURL fetching all of the possible browserNames:

curl --user dauser:dapassword

Supported Endpoints

Endpoint HTTP method Description
data/files/identifiers/apple GET

Returns list of Apple devices and their hardware identifiers.

data/property/{property}/values GET

Returns lists of predefined property values. The following property names should be substituted for {property} in the endpoint path.

  • primaryHardwareType
  • primarySoftwareType
  • osVendor
  • osName
  • osFamily
  • browserVendor
  • browserName
  • browserRenderingEngine
  • contextualUsage
  • highestCellularGeneration
data/webusage/{property}/report GET

Returns lists of Mobile Operating system or Browser names and their most popular versions. The following property names should be substituted for {property} in the endpoint path.

  • osVersion
  • browserVersion


The DeviceAtlas REST API uses HTTP Basic authentication over SSL. Please provide the username and password you would normally login to DeviceAtlas when using the REST API.

Response codes

The REST API returns JSON data with the following response codes:

HTTP Code Description
200 OK Returned on success. The response contains an entity corresponding to the requested resource.
400 Bad Request Returned if the caller submits a badly formed request. For example, the caller can receive this return if you forget a required parameter.
401 Unauthorized Returned if the call requires authentication and either the credentials provided failed or no credentials were provided.
403 Forbidden Returned if the caller attempts to make a call or modify a resource for which the caller is not authorized.
404 Not Found Returned if the specified resource does not exist.

Full example

Download all possible OS names used by devices in DeviceAtlas:

cURL command

curl --user dauser:dapassword


 "Firefox OS",
 "Linux - Arch",
 "Linux - CentOS",
 "Linux - Debian",
 "Linux - Fedora",
 "Linux - Mint",
 "Linux - Red Hat",
 "Linux - Slackware",
 "Linux - Ubuntu",
 "Linux - openSUSE",
 "Mac OS",
 "OS X",
 "Windows 2000",
 "Windows 7",
 "Windows 8",
 "Windows Mobile",
 "Windows Phone",
 "Windows RT",
 "Windows Vista",
 "Windows XP",