Analytics Devices

Returns scan data broken down by operating system and browser, with optional filtering.

GET/analytics/devices

Headers

Header	Required	Description
X-API-Key	Required	Your API key
QR-Version	Optional	API version (e.g., 2026-02-16)

Query Parameters

Parameter	Type	Default	Description
start_date	string	3 months ago	Start date in YYYY-MM-DD format
end_date	string	today	End date in YYYY-MM-DD format
qr_ids	string	—	Comma-separated list of QR code IDs to filter by
country	string	—	Comma-separated list of country codes to filter by
os	string	—	Comma-separated list of operating systems to filter by
type	string	—	Comma-separated list of QR code types to filter by

info

All filter parameters are optional. When omitted, the API returns data for the last 3 months across all QR codes.

Request

cURL

curl -X GET "https://integration-api.qr-build.com/analytics/devices?start_date=2026-01-01&end_date=2026-02-19" \
  -H "X-API-Key: qrb_live_your_api_key_here"

JavaScript

const response = await fetch(
  "https://integration-api.qr-build.com/analytics/devices?start_date=2026-01-01&end_date=2026-02-19",
  { headers: { "X-API-Key": "qrb_live_your_api_key_here" } }
);
const data = await response.json();

Python

import requests

response = requests.get(
    "https://integration-api.qr-build.com/analytics/devices",
    headers={"X-API-Key": "qrb_live_your_api_key_here"},
    params={"start_date": "2026-01-01", "end_date": "2026-02-19"},
)
data = response.json()

Response

{
  "object": "analytics",
  "success": true,
  "data": {
    "os": [
      {
        "name": "iOS",
        "value": 5421,
        "percentage": 42
      },
      {
        "name": "Android",
        "value": 4892,
        "percentage": 38
      },
      {
        "name": "Windows",
        "value": 1823,
        "percentage": 14
      },
      {
        "name": "macOS",
        "value": 711,
        "percentage": 6
      }
    ],
    "browsers": [
      {
        "name": "Safari",
        "value": 4987,
        "percentage": 39
      },
      {
        "name": "Chrome",
        "value": 5234,
        "percentage": 41
      },
      {
        "name": "Firefox",
        "value": 1234,
        "percentage": 10
      },
      {
        "name": "Other",
        "value": 1392,
        "percentage": 10
      }
    ]
  }
}