Analytics

Every scan on a dynamic QR code is recorded and available for analysis in real time.

What gets tracked

Metric	Description
Total scans	All scans, including repeat scans from the same device
Unique scans	Distinct devices (deduped by IP + user-agent per 24h)
Country	Derived from IP geolocation
Device type	iOS, Android, Desktop, Other
Browser	Safari, Chrome, Firefox, etc.
Referrer	HTTP referrer header (when present)
Timestamp	UTC timestamp of each scan event

QRlumo does not store PII (no IP addresses after geolocation lookup on Business plans and above).

Dashboard views

Code-level

Open any dynamic code to see:

• Total and unique scan count
• Daily scan chart (last 30 days)
• Country breakdown (top 10)
• Device breakdown

Project-level

Open a project to see aggregated stats across all codes in that project — useful for comparing campaigns side by side.

Workspace-level

The workspace overview shows total scans, top codes by scan volume, and usage against your plan limits.

Date ranges

Select a custom date range on any chart. Available ranges:

• Last 7 days
• Last 30 days
• Last 90 days
• Custom (from/to)

Data retention:

• Free & Pro: 365 days
• Team: 3 years
• Business: 10 years

Exporting data

CSV export

Download daily aggregates as CSV from any code or project dashboard. Available on Pro and above.

Raw events via API

The /events endpoint returns paginated raw scan events with full metadata. Available on Team and above.

curl https://api.qrlumo.com/v1/workspaces/{id}/qrcodes/{qrId}/events \
  -H "Authorization: Bearer qrl_live_..."

Webhook streaming

Set up a webhook to receive scan events in real time as they happen. See Webhooks.