Skip to main content
REST API

Generate QR Codes at Scale with Our REST API

Integrate QR code creation, management, and analytics into any application. RESTful JSON API with API key authentication, bulk ZIP export, and real-time webhooks.

POST /api/v1/qr-codes
{ "type": "url", "data": "https://example.com" }

The QR-Verse REST API lets developers create, manage, and track QR codes programmatically. Export up to 50 existing codes as a ZIP file via the bulk export endpoint, receive real-time scan notifications via webhooks, and access detailed analytics through dedicated endpoints. Authenticate with a simple API key and start integrating in minutes with any HTTP client.

Create a QR Code in Seconds

One POST request is all it takes. Send your data, get a scannable QR code with a trackable short URL and downloadable image.

Request
cURL
curl -X POST \
https://qr-verse.com/api/v1/qr-codes \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Spring campaign",
"destination_url": "https://example.com"
}'
Response
201 Created
{
"data": {
"id": "qr_abc123",
"name": "Spring campaign",
"qr_type": "url",
"destination_url": "https://example.com",
"is_active": true,
"redirect_slug": "abc123",
"tags": [],
"created_at": "2026-10-09T12:00:00Z"
}
}

Everything You Need to Build

A complete API for QR code lifecycle management. From creation and styling to scan tracking and real-time notifications.

Full CRUD Operations

Create, read, update, and delete QR codes programmatically. Every QR type supported - URL, vCard, WiFi, email, SMS, and more.

Bulk ZIP Export

Export up to 50 existing QR codes as a ZIP file in a single API request. Download PNG or SVG with original styling preserved.

Analytics API

Retrieve scan data programmatically. Totals for a period, plus one record per scan: time, country, city, device type, OS, browser, and UTM parameters.

Webhook Events

Receive real-time HTTP notifications when your QR codes are scanned. Trigger workflows in your CRM, analytics, or automation tools.

API Key Management

Generate, rotate, and revoke API keys from your dashboard. Pro and Business plans support multiple keys for different environments.

Rate Limiting

Creating QR codes through the API is limited to 30 requests per 60 seconds per API key. Above that the API answers with status 429.

API Access by Plan

API access starts at Pro. Business adds bulk import from a CSV file in the web app and higher webhook and API key limits for team environments.

Feature
Free
EUR 0/mo
Pro
€4.99/mo
Business
€12.99/mo
REST API access
API key management
Create / Read / Update / Delete
Dynamic QR codes from a destination URL
Analytics data retrieval
Rate limit (creating codes)030 / min30 / min
Bulk ZIP export (up to 50 codes)
Webhook notifications
Multiple API keys

Built for Your Stack

Whether you run an online store, manage sales pipelines, or automate marketing campaigns - the QR-Verse API fits into your existing workflow.

E-commerce Platforms

Generate QR codes for every product in your catalog automatically. Link to product pages, add to packaging, or embed in receipts. Export existing codes as a ZIP file via API for print and packaging workflows.

Shopify, WooCommerce, or custom storefronts

CRM & Sales Tools

Create personalized QR codes for sales collateral, business cards, or client portals. Use webhooks to log scans as CRM activities and track engagement per contact.

HubSpot, Salesforce, Pipedrive

Marketing Automation

Embed dynamic QR codes in email campaigns, print ads, or event materials. Retrieve scan analytics via API to measure campaign ROI alongside your existing marketing data.

Mailchimp, ActiveCampaign, Zapier

Developer Experience

Built by developers, for developers. Predictable responses, clear documentation, and stable versioning so you can ship with confidence.

Scoped API keys

Give every key only the permissions it needs: qr:read, qr:write, qr:create and analytics:read. A key without the scope of an endpoint gets a 403, and a signed-in session token is not accepted on the API.

JSON Responses

Clean, consistent JSON responses with predictable structure. Every endpoint returns the same format - data, pagination, and error objects you can rely on.

Error Handling

Structured error responses with HTTP status codes, machine-readable error codes, and human-readable messages. Debug issues quickly without guessing.

API Versioning

Versioned API endpoints (v1) with backward compatibility guarantees. Breaking changes only ship in new major versions, so your integration stays stable.

Available Endpoints
GET/api/v1/qr-codes
POST/api/v1/qr-codes
GET/api/v1/qr-codes/:id
PATCH/api/v1/qr-codes/:id
DELETE/api/v1/qr-codes/:id
GET/api/v1/qr-codes/:id/scans

Frequently Asked Questions

What authentication method does the QR-Verse API use?
The API uses API key authentication via Bearer tokens. Include your API key in the Authorization header as "Bearer YOUR_API_KEY". You can generate and manage API keys from your account dashboard.
What QR code types can I create through the API?
The API creates dynamic QR codes that redirect to a destination URL: send a name and a destination_url to POST /api/v1/qr-codes. The type field is a label (url, link, text, email, wifi, vcard, sms, phone, geo, event, crypto or social) and the content is always the URL. Codes with their own data, such as a vCard or WiFi network, are created in the web app.
How does bulk ZIP export work?
Pro and Business plan users can export up to 50 existing QR codes as a single ZIP file via POST /api/qr/bulk-export, with a session or an API key that has the qr:read scope. Specify the IDs of the codes to export and choose PNG or SVG format. The API returns a ZIP download containing each code as a separate file with its original styling preserved.
What happens when I hit the rate limit?
Creating a code (POST /api/v1/qr-codes) is limited to 30 requests per 60-second window per API key. Above that the API answers with status 429 and the message "Rate limit exceeded". The responses carry no rate limit headers and no reset time, so wait a minute and try again.
Can I customize the appearance of QR codes via API?
Not through the v1 API. A code created through the API starts with the default style (black on white); you can restyle it afterwards in the web app. Colors, error correction and output format are not parameters of POST /api/v1/qr-codes.
How do webhooks for scan events work?
Pro and Business plan users can register webhook URLs from the dashboard. When any of your QR codes is scanned, we send a POST request to your webhook URL with scan details: the event and a timestamp, plus the QR code ID and name, country and city, device type, OS, browser, whether the scan is unique, and the UTM parameters (no referrer). Webhooks use HMAC signatures for verification.
Is the API available on the Free plan?
No. API access requires a Pro plan (€4.99/month) or Business plan (€12.99/month). The Free plan includes the web-based QR generator but not programmatic API access.
Can I retrieve analytics data through the API?
Yes. Both Pro and Business plans include API access to scan analytics, with a key that has the analytics:read scope. GET /api/v1/qr-codes/:id/scans returns the scans of a QR code page by page (time, country, city, device type, OS, browser, unique or not, UTM parameters) and a summary with the total scans, the scans and unique scans in the period, and the length of the period. It does not return a breakdown per day, week or month, and no referrer: aggregate the records on your side.

Integrating QR Codes into Your Workflow

The QR-Verse REST API lets you generate, manage, and retrieve scan analytics for QR codes programmatically. Every operation available in the dashboard is available via API, which means your development team can build QR code generation directly into internal tools, e-commerce platforms, fulfilment pipelines, or SaaS products without any manual steps. Authentication uses API keys tied to your account, and rate limits scale with your plan tier.

Common integration patterns include programmatic generation - creating unique QR codes one request at a time, each with a distinct destination URL and optional custom metadata. This is ideal for product serialisation, ticket systems, or loyalty card programmes where each physical item needs its own scannable code. The API returns each generated code as an SVG or PNG in the response body, so codes can be embedded in PDF documents, printed on labels, or stored in your own media library without any intermediate download step.

The scan analytics endpoint gives real-time access to the same data visible in the dashboard - total scans, unique scans, geographic breakdown, device breakdown, and time series data - all in structured JSON. This means you can pipe QR scan events directly into your own data warehouse, CRM, or reporting tool. Webhook support is available on the Pro and Business tiers, enabling push-based integrations where your system is notified instantly when a scan occurs rather than polling the API periodically.

The API is small on purpose: six endpoints under /api/v1, JSON in and out, and an API key with scopes for access. The endpoints are listed on this page, and the example below shows a request and its response. There are no SDK packages and no hosted interactive documentation: a plain HTTP client such as cURL or fetch is all you need.

Pro plan required

Get Your API Key

Sign up for a Pro or Business plan, generate your API key from the dashboard, and start making requests in minutes.

Start Building