API Reference

REST API Reference

Base URL: https://api.qrzone.io/v1 -- All endpoints require an API key passed via the Authorization header.

Authentication

curl -X GET https://api.qrzone.io/v1/codes \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Endpoints

POST/v1/codesCreate a new QR code with type, content, and design settings.

GET/v1/codesList all QR codes with pagination, filtering, and sorting.

GET/v1/codes/:idRetrieve a single QR code by ID with full metadata.

PATCH/v1/codes/:idUpdate a QR code's destination, design, or routing rules.

DELETE/v1/codes/:idDelete a QR code permanently. Scans will return a 404.

GET/v1/codes/:id/scansRetrieve scan analytics for a specific QR code.

POST/v1/codes/bulkCreate up to 10,000 QR codes in a single API call.

GET/v1/analytics/overviewAccount-wide analytics: total scans, top codes, trends.

Example: Create a QR Code

POST /v1/codes
{
  "type": "url",
  "content": "https://example.com",
  "design": {
    "fg_color": "#000000",
    "bg_color": "#ffffff",
    "style": "dots",
    "logo_url": "https://example.com/logo.png",
    "error_correction": "H"
  },
  "routing": {
    "enabled": true,
    "rules": [
      { "condition": "country:US", "destination": "https://us.example.com" }
    ]
  }
}