API QR Code
QR Code Generator REST API — Batch and Analytics
Create, update, list, and analyze QR codes from your own code — REST API with bearer-token auth, 100 RPM per key, batch endpoint for 100 codes per call, and full scan analytics.
Max plan — $20/mo
The REST API ships with the Max plan
Bearer-token auth, 100 RPM per key, batch endpoint up to 100 codes per call, full scan analytics. Generate a key from Settings → API Keys after upgrading.
About API QR Codes
The dashboard is the right tool for printing 50 codes for a trade show. The REST API is the right tool when QR codes are part of your product — when every new customer record needs a vCard QR, every shipment needs a tracking QR, every order confirmation email needs a personalized payment QR. Anything that scales past "I open the dashboard once a week" belongs in the API, not the form.
The surface is small and predictable. POST `/api/v1/qr-codes` with { name, content_type, content, target_url? } creates a code and returns the QR record with its ID, short link, and the URL to fetch the PNG/SVG/PDF. GET `/api/v1/qr-codes` lists your codes with cursor pagination and filters. PATCH `/api/v1/qr-codes/{id}` updates the destination for dynamic codes — repoint without reprinting. GET `/api/v1/qr-codes/{id}/scans` pulls scan analytics broken down by date, country, device, and referrer. POST `/api/v1/qr-codes/batch` creates up to 100 codes per call — chain calls for the same workflows you'd otherwise run via bulk CSV import.
Auth is bearer token: Authorization: Bearer ezqr_your_key in every request. Rate limit is 100 requests per minute per API key; rate-limit headers (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset) come back on every response so retry logic is straightforward. The API is on the Max plan ($20/mo) alongside bulk CSV import; the two pair: bulk for one-shot operations, API for anything continuous. Static codes you create via the API survive cancellation — the destination is encoded into the pattern; dynamic codes route through EZQR's redirect for as long as the subscription is active.
Walkthrough
How to Create a API QR Code
Generate an API key
Sign up, upgrade to the Max plan ($20/mo), and create an API key from Settings → API Keys. Keys are scoped to your account and revocable at any time. Name each key by environment (
prod,staging,dev-tasnim) so audit logs are useful.Make your first request
POST /api/v1/qr-codeswith{ "name": "Customer 4471", "content_type": "url", "content": "https://app.example.com/c/4471", "target_url": "https://ez-qr.com/r/abc123" }and anAuthorization: Bearer ezqr_...header. Response: the QR record withid,short_code, and asset URLs for PNG/SVG/PDF.Batch-create where the workflow allows
POST /api/v1/qr-codes/batchtakes an array of up to 100 code definitions in one call. Single-call overhead per code drops to milliseconds, and you stay well under the 100 RPM rate limit. Chain calls if you need more than 100 codes; pair with the bulk CSV import for one-shot operations larger than that.Repoint dynamic codes after printing
PATCH /api/v1/qr-codes/{id}with{ "target_url": "https://new-destination.com" }updates the redirect for a dynamic code. The printed QR stays the same; the destination changes server-side. Useful when campaigns end, product pages move, or experimental landing pages get rotated.Pull analytics for attribution and dashboards
GET /api/v1/qr-codes/{id}/scans?from=2026-01-01&to=2026-01-31returns aggregated scan counts by date, country, device, and referrer. Pipe into your warehouse, attribution platform, or internal dashboard — every printed-campaign scan is now structured data your team can query.
API QR Code FAQ
Common questions about generating, printing, and deploying these codes.
How much does the API cost?
API access is on the Max plan at $20/mo. No per-request fees, no per-code fees. Rate limit is 100 requests per minute per API key, with batch creation up to 100 codes per call — so the effective ceiling is ~10,000 new codes per minute per key. If your workflow needs more, contact us and we'll talk about a custom rate-limit tier.
What can I do with the API?
Full CRUD on QR codes plus analytics: create (single or batch up to 100), read (list with cursor pagination, get individual), update (repoint dynamic codes, rename, toggle active), delete (soft delete with 30-day undo), and scan analytics broken down by date, country, device, and referrer. Plus API-key management endpoints for rotation.
What authentication does the API use?
Bearer token auth. Include Authorization: Bearer ezqr_your_key in every request. Keys are generated from your dashboard at Settings → API Keys and are scoped to a single EZQR account. Per-environment scopes let you restrict a staging key to staging codes; production keys can be flagged as read-only or write-only.
Does the API return QR images directly?
The create endpoint returns the QR record with asset URLs for the rendered PNG, SVG, and PDF — fetch the image at the URL when you need it, or pre-cache the URL string in your database. The API itself doesn't stream binary images on the create call; this keeps the response payload small and lets you cache images at your CDN edge instead of EZQR's.
Will codes created via the API survive cancellation?
Static codes (created without a `target_url`) survive forever — the content is encoded into the QR pattern, no server dependency. Dynamic codes (created with a `target_url`) route through EZQR's redirect and need an active subscription. Pick the right tool: static for permanent destinations (asset tags, packaging), dynamic for anything you might need to repoint.
Related Industries
Logistics QR Codes for Freight & Warehouses
Create QR codes for digital bills of lading, proof of delivery, and warehouse receiving. Real-time shipment tracking with dynamic codes.
Free Event QR Codes: Tickets, Check-in & Schedules
Free QR codes for event management — tickets, attendee check-in, live schedules, WiFi, session feedback. Cut check-in lines and handle last-minute changes.
Related Guides
Dynamic vs Static QR Codes: What Is the Difference?
Dynamic vs static QR codes in 2026: how each works, when to pick which, real pricing, and the vendor-cancellation trap that kills printed dynamic codes.
How to Create a QR Code (Step-by-Step Guide)
How to create a QR code in 60 seconds: pick a content type, fill the form, add colors and a logo, then download PNG or SVG. No signup for static codes.
Related Tools
Bulk QR Code Generator
Generate hundreds of unique QR codes from a CSV.
Dynamic QR Code Generator
Editable destination — change the URL without reprinting.
vCard QR Code Generator
Contact card QR for business cards and signatures.
URL QR Code Generator
Generate a QR code for any web link, free with no signup.
barcode QR Code Generator
Free QR code generator on EZQR.
Ready to create your API QR code?
Free, no watermarks. Generate and download in seconds.
Generate Free QR Code