Public REST API v1.0

QRnaly Developer Platform

The versioned REST API for modern QR generation, dynamic shortlink routing, document hosting, and privacy-preserving scan telemetry.

Paid Plan Feature: REST API access and API key creation are available on Pro and Business plans. Technical documentation remains completely public for all users.View Pricing →

Base URL

https://qrnaly.com/api/v1

Authentication

Authorization: Bearer <key>

Rate Limits

30 (Pro) • 60 (Business) req/min

Explore Developer Resources

Quickstart Guide

Set up your Workspace, generate your first API key, and create a dynamic QR code in under 5 minutes.

Learn more

Authentication & Scopes

Secure Bearer token headers, high-entropy qrs_live_ keys, scoped permissions, and key rotation.

Learn more

QR Codes API

Create, retrieve, update destination URLs post-print, and export vector SVGs programmatically.

Learn more

Documents API

Cloud hosting for PDF menus, property brochures, and images linked directly to dynamic QR codes.

Learn more

Scan Analytics API

Privacy-preserving salted IP hash metrics, 30-day time-series telemetry, device and city rollups.

Learn more

Webhooks & Events

Real-time HTTP push callbacks for scan.recorded, qr.created, and lead capture CRM integrations.

Learn more

Core Architectural Principles

Server-Side Tenant IsolationAll API keys resolve workspaces and permissions server-side. Request payload parameters cannot tamper with workspace IDs or roles.

QR Credits AbstractionTransparent usage accounting: dynamic creation consumes 1 credit, document upload consumes 2 credits, updates and exports are free.

Privacy-Preserving TelemetryScanner telemetry utilizes non-reversible SHA-256 salted IP hashes, satisfying both DPDP Act 2023 and GDPR requirements.