Qorlie
Scan Pass REST API & Remote MCP

Qorlie REST API, OpenAPI & MCP Connector

Create editable QR codes, bulk-import CSVs, pull scan stats, subscribe to HMAC-signed webhooks, or connect AI assistants over remote MCP with OAuth 2.1 + PKCE.

Remote MCP Connector

Provision editable QR codes and pull scan analytics from ChatGPT, Claude, or Cursor.

iOS, Android & Web App

Inspect live scans, countries, and heatmaps on the go with native Liquid Glass polish.

9:41
QR Dashboard
Fall Bistro Menu1,842
/s/bistro-menu
Launch Flyer11,240

Discovery Endpoints

Authentication

Generate an API key (ql_live_...) from Account tools (Scan Pass) in the Qorlie dashboard, then pass it in X-API-Key or Authorization: Bearer ql_live_....

curl -X POST "https://api.qorlie.com/api/v1/qrs" \
  -H "X-API-Key: ql_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Spring Menu",
    "destinationUrl": "https://example.com/menu.pdf",
    "customSlug": "spring-menu",
    "utmParams": { "utmSource": "table_tent", "utmMedium": "qr" }
  }'

REST v1 Endpoints

  • GET /api/v1/qrs — List editable QR codes
  • POST /api/v1/qrs — Create editable QR code (supports UTM, password, expiry). Short slugs are claimed forever and never recycled.
  • POST /api/v1/qrs/bulk — Bulk create from CSV or JSON array (up to 100/call)
  • PATCH /api/v1/qrs/:id — Update destination, lock, slug, UTM, password, or archive. Locked destinations need reauthToken from POST /api/auth/step-up.
  • DELETE /api/v1/qrs/:id — Retire a link forever; the slug stays tombstoned and scanners see a neutral retired page
  • GET /api/v1/qrs/:id/destination-history — Append-only destination change log
  • POST /api/import/bitly/preview — Preview Bitly CSV/token import + credit cost (new Qorlie shorts only)
  • POST /api/import/bitly/confirm — Confirm import; returns mapping + replace checklist
  • GET /api/link-health/alerts — Dead destinations, redirect domain changes, domain expiry alerts
  • POST /api/v1/qrs/:id/duplicate — Duplicate an existing editable QR
  • GET /api/v1/analytics/account?range=30d&granularity=day&compare=true — Account-wide scan series, geo cities, tech & heatmap
  • GET /api/v1/qrs/:id/analytics?range=30d&granularity=week — Per-code analytics by day/week/month, geo, OS/browser, referrer & heatmap
  • GET /api/v1/qrs/:id/analytics/export?range=30d — Download CSV analytics report

Remote MCP Tools

Connect Claude, ChatGPT, or Cursor directly to https://api.qorlie.com/mcp via OAuth 2.1 with dynamic client registration (POST /oauth/register) and PKCE:

  • create_static_qr — Render free browser SVG & scanability check
  • create_dynamic_qr — Provision an editable short link and QR code (slug claimed forever)
  • update_dynamic_qr — Update destination or title; locked links need unlock + reauthToken
  • import_bitly_csv — Preview Bitly CSV import cost (confirm via REST; never claims bit.ly slugs)
  • list_dynamic_qrs — List editable codes, scan counts, and short URLs
  • get_qr_analytics — Pull per-code series, unique scans, cities, OS/browser, heatmap & delta
  • get_account_analytics — Pull account-wide rollups, top codes & geo distribution
  • bulk_create_dynamic_qrs — Batch create editable codes
Updated