Analytics Scans

Returns daily scan data over a specified date range, with optional filtering by QR code, country, operating system, and QR type.

GET/analytics/scans

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/scans?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/scans?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/scans",
    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": [
    {
      "date": "2026-02-17",
      "scans": 142,
      "unique_scans": 98
    },
    {
      "date": "2026-02-18",
      "scans": 156,
      "unique_scans": 112
    },
    {
      "date": "2026-02-19",
      "scans": 89,
      "unique_scans": 67
    }
  ]
}