Qr-code generation
QR Code Generation API with two modes: Static (URL encoded directly) and Dynamic (editable short link that redirects to any destination — update the target anytime without reprinting the QR). Features: • Branded styling — logos, gradients, custom dot/corner shapes, color control • Output formats — PNG and SVG • Scan analytics — country, city, device, browser, unique vs repeat scans (retention…
Qr-code generation endpoints
| Method | Endpoint | Description |
|---|---|---|
| POST |
Bulk generate QR codes /qr/bulk-generate |
Batch-create up to 50 QR codes in one request. Requires Ultra or Mega tier. Each item is independently subject to `DYNAMIC_QR_LIMIT` — a failure on one item does not abort the… |
| GET |
List scan webhook endpoints /webhooks/scan-endpoints |
List all scan-notification endpoints registered by the authenticated user. Returns metadata only — secrets are never returned after the initial registration |
| DELETE |
Delete scan webhook endpoint /webhooks/scan-endpoints/{id} |
Unregister a scan-notification endpoint by its ID |
| GET |
Scan analytics for a QR /qr/{qr_id}/stats |
Aggregated scan analytics for a dynamic QR: total/unique scans, scans by day/country/device/browser. Retention depends on tier — Pro 30d, Ultra 90d, Mega 1y; Free has no… |
| POST |
Generate QR code (static or dynamic) /qr/generate |
Generates a PNG or SVG QR code. Returns the image as a base64-encoded string. Set type: "dynamic" to get an editable short link (destination URL can be updated later without… |
| PATCH |
Update dynamic QR destination /qr/{qr_id}/destination |
Update the destination URL of a dynamic QR. The next scan resolves to the new URL — the printed QR image never changes. Only works on `type: "dynamic"` QRs; calling this on a… |
| POST |
Register scan webhook endpoint /webhooks/scan-endpoints |
Register an HTTPS endpoint to receive a signed POST on every QR scan. Requires Mega tier (`canUseWebhooks`). Maximum 5 endpoints per account. The `secret` is returned ONCE —… |
| GET |
Get QR metadata /qr/{qr_id} |
Retrieve metadata for a previously generated QR: type, original URL, current destination (for dynamic), short code, style config snapshot, error-correction level, timestamps |
Qr-code generation pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | 10 / second |
|
| PRO Recommended | $12 / month | 10 / second |
|
| ULTRA | $35 / month | 10 / second |
|
| MEGA | $75 / month | 10 / second |
|