REST API

Create and manage editable QR codes from your own software. Included in the Business plan. Base URL: https://qr.digitalleon.com/api/v1

Authentication

Create a key in Domains & API. Send it in the Authorization header. Keys have full access to your account: keep them on your server, never in website or app code.

curl https://qr.digitalleon.com/api/v1/codes \
  -H "Authorization: Bearer qrs_your_key_here"

Limits: 60 requests per minute per key. Errors always look like {"error":{"code":"…","message":"…"}} with the matching HTTP status (400, 401, 403, 404, 413, 429).

Code types

WEBSITEVCARDBUSINESSLINKSMENUPDFIMAGESVIDEOMP3APPSCOUPONEVENTSOCIALRATINGFEEDBACKFACEBOOKINSTAGRAMWIFIWHATSAPPSMSEMAILSMARTBOOKINGREVIEWPAYMENTMAP

The content object has the same fields as the editor. Tip: create a code of a type once with no content, then GET it to see the full shape.

Endpoints

GET/codes

Lists codes, newest first. Query: limit (1–100, default 50), cursor (from nextCursor), folderId.

{
  "data": [{
    "id": "cm…", "name": "Shop window", "type": "WEBSITE", "status": "ACTIVE",
    "scanUrl": "https://qr.digitalleon.com/q/Ab3dE7x", "folderId": null,
    "scanCount": 42, "lastScannedAt": "2026-11-19T10:00:00.000Z",
    "content": { "url": "https://example.com/" },
    "createdAt": "…", "updatedAt": "…"
  }],
  "nextCursor": null
}

POST/codes

Creates a code. Body: type (required), name, content, folderId. Returns 201 with the code. Put scanUrl into any QR generator or print it from the dashboard.

curl -X POST https://qr.digitalleon.com/api/v1/codes \
  -H "Authorization: Bearer qrs_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"type":"WEBSITE","name":"Flyer March","content":{"url":"https://example.com/offer"}}'

GET/codes/{id}

Returns one code.

PATCH/codes/{id}

Changes name, status (ACTIVE / PAUSED), folderId or the full content object. Printed codes show the new content immediately.

curl -X PATCH https://qr.digitalleon.com/api/v1/codes/cm123… \
  -H "Authorization: Bearer qrs_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"content":{"url":"https://example.com/new-offer"}}'

DELETE/codes/{id}

Deletes a code permanently. Returns 204. Printed copies stop working — use PAUSED if you might need it again.

GET/codes/{id}/stats

Scan statistics. Query: range = 7, 30, 90 or 365 days. Returns totals, unique visitors, scans per day, per hour (UTC), and top countries, cities, devices, OS, browsers and referrers.