qrlogo.org API

Authentication

Every request must include an Authorization: Bearer <key> header. Generate a key from the dashboard — it's a 51-character string starting with qr_.

API access is included on the Advanced ($10/mo) and Premium ($20/mo) plans. Free and Regular accounts can create a key but every request returns 403 api_not_available.

Rate limits & quotas

If you exceed the quota, the API returns 429 quota_exceeded until the next reset. There is no per-second rate limit beyond the monthly cap.

Create a QR POST

POST /api/v1/qr

Creates a dynamic URL QR code. The server generates a unique short_code and returns the canonical scan URL. Counts against your dynamic-QR plan limit (Advanced: 200, Premium: unlimited).

Body parameters

Example

curl -X POST https://qrlogo.org/api/v1/qr \
    -H "Authorization: Bearer qr_" \
    -H "Content-Type: application/json" \
    -d '{
      "label": "Restaurant menu — fall 2026",
      "target_url": "https://example.com/menu",
      "fg_color": "#1d4ed8",
      "bg_color": "#ffffff"
    }'

Response (201 Created)

{
  "id": 42,
  "short_code": "kpnh7vy",
  "label": "Restaurant menu — fall 2026",
  "qr_type": "url",
  "target_url": "https://example.com/menu",
  "scan_url": "https://qrlogo.org/r.php?c=kpnh7vy",
  "scan_count": 0,
  "fg_color": "#1d4ed8",
  "bg_color": "#ffffff",
  "created_at": "2026-04-07 14:30:12",
  "updated_at": "2026-04-07 14:30:12"
}

The scan_url is what you encode into the printed QR code. Every scan of that URL goes through /r.php and gets logged.

List QR codes GET

GET /api/v1/qr

Returns up to 200 of the authenticated user's QR codes, newest first. Each row includes the current scan count.

Example

curl https://qrlogo.org/api/v1/qr \
    -H "Authorization: Bearer qr_"

Response (200 OK)

{
  "count": 2,
  "qrs": [
    { "id": 42, "short_code": "kpnh7vy", "label": "...", "scan_count": 17, ... },
    { "id": 41, "short_code": "9bjkmqt", "label": "...", "scan_count": 4,  ... }
  ]
}

Fetch one QR code GET

GET /api/v1/qr/{short_code}

Returns a single QR code with its current scan count. Returns 404 not_found if the short_code doesn't belong to the authenticated user.

Example

curl https://qrlogo.org/api/v1/qr/kpnh7vy \
    -H "Authorization: Bearer qr_"

Error responses

Errors are JSON with the shape {"error": "code", "message": "human-readable text"}.