REST API

Dynamic QR codes via API

Generate, redirect, and track QR scans with one API. Ship unique codes on every item—repoint destinations anytime, get scan events in real-time.

Bulk creation

Generate hundreds of QR codes with a single API call. Perfect for inventory, packaging, or event management.

Editable destinations

Change where any QR points after printing. No reprinting, no waste, no downtime.

Real-time analytics

Track scans as they happen. Get location, device, and timing data via API or webhooks.

Tokens + rate limits

Simple bearer token auth. Generous rate limits on every plan, from 10 req/min free to 300 req/min enterprise.

Quickstart

Create your first QR code in under a minute. All you need is an API key.

1

Create a QR code

curl
curl -X POST https://api.seriousqr.com/v1/qrcodes \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Product Launch Campaign",
    "type": "url",
    "destination": "https://example.com/launch"
  }'
2

Get your QR code

Response 200 OK
{
  "id": "qr_abc123",
  "name": "Product Launch Campaign",
  "type": "url",
  "destination": "https://example.com/launch",
  "short_url": "https://qr.lp/abc123",
  "image_url": "https://cdn.seriousqr.com/abc123/public",
  "scans": 0,
  "status": "active",
  "created_at": "2026-02-05T12:00:00Z"
}
3

Update the destination (anytime)

curl
curl -X PATCH https://api.seriousqr.com/v1/qrcodes/qr_abc123 \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "destination": "https://example.com/v2-launch"
  }'

The same printed QR code now points to a new URL. No reprinting needed.

4

Fetch analytics

curl
curl https://api.seriousqr.com/v1/analytics/qrcodes/qr_abc123 \
  -H "Authorization: Bearer sk_live_your_api_key"

Authentication & Limits

Authentication

All API requests require a Bearer token in the Authorization header.

Authorization: Bearer sk_live_xxx

Generate API keys in your account settings.

Rate Limits

Free 10 req/min
Pro 60 req/min
Business 120 req/min
Enterprise 300 req/min

Rate limit headers included in every response: X-RateLimit-Remaining, X-RateLimit-Reset

Built for real use cases

From product packaging to event management, see how teams use our API to build smart, dynamic systems.

Product packaging

Print QR codes on packaging, update destination URLs post-launch for campaigns or recalls.

Inventory management

Generate codes for assets, track check-ins/check-outs, update metadata without reprinting.

Event ticketing

Create unique QR codes per ticket, validate scans in real-time, prevent duplicates.

Marketing campaigns

Launch A/B tests by changing destinations, measure engagement, optimize in real-time.

Restaurant menus

Update prices, add seasonal items, or change suppliers without reprinting table tents.

Asset tracking

Tag equipment, track location history, manage maintenance schedules via scan events.

API access on every plan

Start free. Upgrade for higher limits.

  • Free: 100 API QR codes, 10 req/min
  • Pro ($19/mo): 50 QR codes, 60 req/min
  • Business ($49/mo): 250 QR codes, 120 req/min
  • Webhooks for real-time scan events
  • No credit card required to start

Need unlimited QR codes and 300 req/min? See enterprise plans.

Developer FAQ

Common questions about our API. Need more help? Contact support.

How do I get API access?
API access is included on every plan, including Free. Sign up, generate an API key from the API Keys page, and start building. Free tier includes 100 API-created QR codes at 10 req/min. Paid plans get higher limits.
What are the rate limits?
Free: 10 req/min. Pro ($19/mo): 60 req/min. Business ($49/mo): 120 req/min. Enterprise: 300 req/min with custom burst limits. Need more? Contact us.
Is there a sandbox/test environment?
Yes. Use the x-sandbox: true header to create test QR codes that don't count against your quota and auto-delete after 24 hours.
Do you support webhooks?
Yes. Configure webhook endpoints in your account to receive real-time scan events, including location, device, and custom metadata.
What authentication method do you use?
Simple Bearer token authentication. Include your API key in the Authorization header: Authorization: Bearer sk_live_xxx
Can I use the API for white-label solutions?
Yes. The API returns raw data and image URLs. You control the UX entirely. Contact us for volume pricing on white-label deployments.

Ready to build?

Get your free API key and start creating QR codes in minutes.