QR Code API - Dynamic Codes & Scan Analytics, Programmatically
The same primitives behind the dashboard - dynamic codes, destination edits, scan logs - available to your own software on the Business plan.
Every QRmaker dynamic code is built on two simple primitives: a permanent short redirect you control, and a scan log that records every hit. API access on the Business plan puts those primitives in reach of your own systems, so your software can work with dynamic QR codes - creating them, re-pointing destinations, and reading scan analytics - without a human clicking through the dashboard. Scan data is available today as CSV over a single authenticated endpoint, documented below.
What you get
Dynamic codes from your stack
API access on the Business plan covers programmatic work with dynamic codes: generating a code and updating where its permanent redirect points - the same editing the dashboard does.
Scan analytics retrieval
Every scan logs timestamp, device class, OS, browser, and coarse location. Pull a code's complete scan log as CSV from an authenticated endpoint and load it into your warehouse or BI tool.
Simple, standard auth
Requests authenticate with your account's session token - a 30-day JWT issued at login and sent as an HTTP-only cookie. Plain HTTPS requests, no SDK required.
How it works
- 1
Upgrade to Business - API access is included, alongside 5 team seats and a custom short-link domain.
- 2
Authenticate: sign in to get your session token (a 30-day JWT) and send it as the qrm_session cookie with your requests.
- 3
Pull your data: fetch any code's scan log as CSV from the export endpoint and automate your workflow around it.
Getting started
The API builds on the same two features the rest of the product runs on. If you haven't used them yet, start with dynamic QR codes - codes whose destination you can edit after printing - since those are the codes an integration can update and measure. Every dynamic code also comes with scan tracking, which logs each scan's time, device, and location; that scan log is what the export endpoint below returns.
The scan-analytics export is a plain authenticated HTTPS endpoint - no SDK, no special client:
curl
# Download a code's full scan log as CSV
curl "https://qrmkr.io/api/export/<code-id>" \
-H "Cookie: qrm_session=<session-token>" \
-o scans.csvNode.js
const res = await fetch(`https://qrmkr.io/api/export/${codeId}`, {
headers: { cookie: `qrm_session=${sessionToken}` },
});
const csv = await res.text();
// columns: timestamp,device,os,browser,country,city,refererAuthentication
Requests authenticate with your account's session token: signing in issues a JWT valid for 30 days, delivered as an HTTP-only cookie named qrm_session. Send that cookie with each request, keep the token secret - it grants full account access - and always call the API over HTTPS. Programmatic code creation and destination editing are part of the Business plan's API access - contact support@qrmkr.io after upgrading and we'll get your integration set up.
FAQ
What can the QRmaker QR code API do?
API access is a Business-plan feature covering programmatic use of dynamic QR codes: creating codes, updating a code's destination URL, and retrieving scan analytics. The scan-analytics export documented on this page is live today; when you start a Business plan, contact support@qrmkr.io and we'll get your integration set up.
How does API authentication work?
With your account's session token. Logging in issues a JWT valid for 30 days, delivered as an HTTP-only cookie named qrm_session. Send that cookie with requests from your integration. Keep the token secret - it grants full account access - and always call the API over HTTPS.
What's in the scan analytics export?
One CSV row per scan: timestamp, device class, operating system, browser, country, city, and referer. Location is coarse (country/city level), and we store a salted hash instead of raw IP addresses.
Which plan includes API access?
Business, at $39/month (or an effective $32/month billed yearly). It includes everything in Pro - unlimited dynamic codes, destination editing, scan analytics - plus up to 5 team members, a custom short-link domain, API access, and higher AI Art QR limits.
Can I try the data export before upgrading?
The CSV scan export isn't available on the free plan. But your first dynamic code is free forever, so you can start collecting real scan data now and upgrade when you're ready to pull it programmatically.
Ready to put QR codes in your pipeline?
API access is part of the Business plan - $39/month, everything in Pro included, cancel anytime.
See Business pricing