QR Code API Quick Start
The QR Code Genius API lets you generate QR codes programmatically: fully-styled PNG images, bulk batches with scan tracking, and lightweight images you can embed directly in a web page or email.
Create an API key
- Sign in and open the Developer Dashboard.
- Click Create API Key and give it a name.
- Copy the key immediately — it is shown only once. Only a secure hash is stored on our servers, so a lost key must be revoked and replaced.
Keys look like this:
qrc_9f8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c...
Base URL
https://www.qrcodegenius.com/api/v1
Your first request
Pass your key in the Authorization header and POST the content you want to encode:
curl -X POST https://www.qrcodegenius.com/api/v1/qr \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "data": "https://example.com", "width": 512, "height": 512 }'
The response contains the QR code as a base64 PNG data URL, plus your current usage:
{
"success": true,
"data": "data:image/png;base64,iVBORw0KGgo...",
"meta": { "usage_count": 1, "remaining": 49, "strategy": "monthly" }
}
Endpoints
- POST /qr — generate a single, fully-styled QR code. See Generate a QR code.
- POST /qr/bulk — generate up to 100 QR codes in one call and save them to your account, optionally as trackable dynamic codes (Pro plan). See Bulk QR generation.
- GET /render — a fast, cacheable PNG you can use directly in an
imgtag. See Embed a QR image.
Plans and limits
- Free: 50 API requests per month.
- Pro: 1,000 API requests per month, plus access to bulk generation.
- Purchased credits are used automatically once the monthly allowance runs out.
See Errors and rate limits for details on quotas and error handling.
Never expose your API key in client-side code (browsers or mobile apps). Call the API from your backend server to keep your credentials secure. The only exception is the render endpoint, which is designed for image embedding — see its documentation for the trade-offs.
Was this article helpful?
Your feedback helps us improve our documentation.