Scan-level statistics (BI / export)
Paginated raw scan rows for your tracked links. Intended for dashboards (e.g. Power BI) and custom reporting. Requires API access, analytics, and the scan reporting API option on your plan.
GET https://www.qrco.au/api/statistics-scans
Without link_ids or qr_code_ids you may query at most 7 calendar days across all your links. With either filter present, up to 93 calendar days for the filtered links.
| Parameters | Details | Description |
|---|---|---|
| start_date | Required | Start date in Y-m-d format. |
| end_date | Required | End date in Y-m-d format. |
| link_ids | Optional String | Optional. Comma-separated link IDs; each must belong to your account. When used with qr_code_ids, scans matching any resolved link are returned. |
| qr_code_ids | Optional String | Optional. Comma-separated dynamic QR code IDs belonging to your account. Static QR codes (no linked tracked link) are rejected. Resolved link IDs are unioned with link_ids. |
| page | Optional Integer | The page number that you want results from. Defaults to 1. |
| results_per_page | Optional Integer | How many results you want per page. Allowed values are: 10, 25, 50, 100, 250. Defaults to 25. |
curl --request GET \
--url 'https://www.qrco.au/api/statistics-scans?start_date=2025-01-01&end_date=2025-01-07&results_per_page=25&page=1' \
--header 'Authorization: Bearer {api_key}' \
--url 'https://www.qrco.au/api/statistics-scans?start_date=2025-01-01&end_date=2025-01-07&results_per_page=25&page=1' \
--header 'Authorization: Bearer {api_key}' \
Each row includes: id, link_id, user_id, country_code, continent_code, os_name, city_name, browser_name, referrer_host, referrer_path, device_type, browser_language, utm_source, utm_medium, utm_campaign, is_unique, datetime, link_slug, location_url, qr_code_ids, qr_code_names.
{
"data": [
{
"id": 1001,
"link_id": 55,
"user_id": 3,
"country_code": "AU",
"continent_code": "OC",
"os_name": "iOS",
"city_name": "Sydney",
"browser_name": "Mobile Safari",
"referrer_host": "qr.example.com",
"referrer_path": "/c/summer",
"device_type": "mobile",
"browser_language": "en-AU",
"utm_source": "qr",
"utm_medium": "print",
"utm_campaign": "summer2025",
"is_unique": 1,
"datetime": "2025-01-05 14:22:00",
"link_slug": "summer-sale",
"location_url": "https://example.com/landing",
"qr_code_ids": "12|44",
"qr_code_names": "Poster A | Table tent"
}
],
"meta": {
"page": 1,
"total_pages": 4,
"results_per_page": 25,
"total_results": 100,
"start_date": "2025-01-01 00:00:00",
"end_date": "2025-01-07 23:59:59",
"max_date_range_days": 7
},
"links": {
"first": "https://www.qrco.au/api/statistics-scans?start_date=2025-01-01&end_date=2025-01-07&results_per_page=25&page=1",
"last": "https://www.qrco.au/api/statistics-scans?start_date=2025-01-01&end_date=2025-01-07&results_per_page=25&page=4",
"next": "https://www.qrco.au/api/statistics-scans?start_date=2025-01-01&end_date=2025-01-07&results_per_page=25&page=2",
"prev": null,
"self": "https://www.qrco.au/api/statistics-scans?start_date=2025-01-01&end_date=2025-01-07&results_per_page=25&page=1"
}
}