QR Code API Preview

This page previews the REST API surface for dynamic QR creation, destination edits, batch jobs, and scan analytics. Protected `/api/qrs` routes are wired for Supabase ownership checks; API keys, billing, and analytics require the remaining production credentials.

Planned endpoints

POST/v1/codesPlanned: create a static or dynamic code

GET/v1/codes/:idPlanned: fetch a code and asset URLs

PATCH/v1/codes/:idPlanned: re-point a dynamic destination

GET/v1/codes/:id/scansPlanned: pull scan analytics

POST/v1/codes/batchPlanned: create many codes at once

Public API request shape

# Public v1 API shape planned; protected app routes use /api/qrs today
curl -X POST https://api.qrserra.com/v1/codes \
  -H "Authorization: Bearer sk_preview_..." \
  -H "Content-Type: application/json" \
  -d '{
    "type": "dynamic",
    "destination": "https://restaurant.com/menu",
    "style": { "module": "rounded", "fg": "#0a0c10", "logo": "brand" }
  }'

# Planned response shape
{
  "id": "qr_m4p9x",
  "short_url": "https://qrserra.com/m4p9x",
  "png": "https://api.qrserra.com/v1/codes/qr_m4p9x.png",
  "svg": "https://api.qrserra.com/v1/codes/qr_m4p9x.svg",
  "scans": 0
}

Planned re-point request

# Planned behavior: the printed code stays the same while the destination changes
curl -X PATCH https://api.qrserra.com/v1/codes/qr_m4p9x \
  -H "Authorization: Bearer sk_preview_..." \
  -d '{ "destination": "https://restaurant.com/summer-menu" }'

Roadmap for scale

Batch creation

Planned batch generation for one code per product, table or location.

Webhooks

Planned webhook notifications for scan thresholds and route events.

Brand kits

Planned saved styles and custom domains for generated codes.

Need it now?

The browser generator covers real single static codes today. API and CSV batch generation are roadmap items.

Bulk from CSV Generate static QR →

Loading qrserra

QR Code API Preview

Public API request shape

# Public v1 API shape planned; protected app routes use /api/qrs today curl -X POST https://api.qrserra.com/v1/codes \ -H "Authorization: Bearer sk_preview_..." \ -H "Content-Type: application/json" \ -d '{ "type": "dynamic", "destination": "https://restaurant.com/menu", "style": { "module": "rounded", "fg": "#0a0c10", "logo": "brand" } }' # Planned response shape { "id": "qr_m4p9x", "short_url": "https://qrserra.com/m4p9x", "png": "https://api.qrserra.com/v1/codes/qr_m4p9x.png", "svg": "https://api.qrserra.com/v1/codes/qr_m4p9x.svg", "scans": 0 }

# Planned behavior: the printed code stays the same while the destination changes curl -X PATCH https://api.qrserra.com/v1/codes/qr_m4p9x \ -H "Authorization: Bearer sk_preview_..." \ -d '{ "destination": "https://restaurant.com/summer-menu" }'