API Overview

The SeriousQR API lets you create, update, and manage QR codes programmatically. Build QR code generation into your own applications and workflows.

API access is included on every plan, including Free. Generate an API key in your account settings to get started. See plan limits.

Base URL

All API requests are made to:

https://api.seriousqr.com/v1

Authentication

The API uses Bearer token authentication. Include your API key in the Authorization header:

Authorization: Bearer sk_live_xxxxxxxxxxxx

API keys can be created in your account settings. Keep your keys secure—they provide full access to your account.

Key Types

  • Live keys (sk_live_) - For production use. QR codes are publicly accessible.
  • Test keys (sk_test_) - For development. QR codes are isolated and don't count against limits.

Request Format

All requests should use JSON bodies with the Content-Type: application/json header.

curl -X POST https://api.seriousqr.com/v1/qrcodes \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "destination_url": "https://example.com"
  }'

Response Format

All responses are JSON. Successful responses return the requested data directly:

{
  "id": "qr_abc123",
  "short_code": "abc123",
  "destination_url": "https://example.com",
  "created_at": "2026-02-05T12:00:00Z"
}

Error responses include an error object:

{
  "error": {
    "code": "invalid_request",
    "message": "destination_url is required"
  }
}

Rate Limits

API requests are rate limited based on your plan:

Plan Requests/minute API QR codes
Free 10 100
Pro 60 Shared pool (50)
Business 120 Shared pool (250)
Enterprise 300 Unlimited

Endpoints

QR Codes

POST /v1/qrcodes
Create a QR code
GET /v1/qrcodes
List all QR codes
GET /v1/qrcodes/:id
Get a QR code
PATCH /v1/qrcodes/:id
Update a QR code
DELETE /v1/qrcodes/:id
Delete a QR code

Analytics

GET /v1/qrcodes/:id/analytics
Get QR analytics
GET /v1/analytics/aggregate
Aggregate analytics

Support

Need help with the API? Contact us at api@seriousqr.com.