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
- OpenAPI 3.1 JSON: https://api.qorlie.com/api/openapi.json
- Remote MCP Endpoint:
https://api.qorlie.com/mcp - OAuth 2.1 Authorization Server Metadata: https://api.qorlie.com/.well-known/oauth-authorization-server
- LLM Index & Pricing JSON: https://qorlie.com/llms.txt · https://qorlie.com/pricing.json
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 codesPOST /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 needreauthTokenfromPOST /api/auth/step-up.DELETE /api/v1/qrs/:id— Retire a link forever; the slug stays tombstoned and scanners see a neutral retired pageGET /api/v1/qrs/:id/destination-history— Append-only destination change logPOST /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 checklistGET /api/link-health/alerts— Dead destinations, redirect domain changes, domain expiry alertsPOST /api/v1/qrs/:id/duplicate— Duplicate an existing editable QRGET /api/v1/analytics/account?range=30d&granularity=day&compare=true— Account-wide scan series, geo cities, tech & heatmapGET /api/v1/qrs/:id/analytics?range=30d&granularity=week— Per-code analytics by day/week/month, geo, OS/browser, referrer & heatmapGET /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 checkcreate_dynamic_qr— Provision an editable short link and QR code (slug claimed forever)update_dynamic_qr— Update destination or title; locked links needunlock+reauthTokenimport_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 URLsget_qr_analytics— Pull per-code series, unique scans, cities, OS/browser, heatmap & deltaget_account_analytics— Pull account-wide rollups, top codes & geo distributionbulk_create_dynamic_qrs— Batch create editable codes
Developer & Pricing Links
Updated