§DEVELOPERS
How to integrate QR code generation into your application?
The codigo-qr.es REST API generates static and dynamic QR codes, manages them and returns PNG or SVG images from any language with a single call.
Requires Pro plan
Can I use the API without signing up?
Yes. The public endpoint generates static QR codes with no account and no API key, limited to 50 requests per day per IP.
Use POST /api/v1/qr/render with the QR content, format and size. You get the image in base64. No sign-up, no credit card.
Example without authentication
curl -X POST https://codigo-qr.es/api/v1/qr/render \
-H "Content-Type: application/json" \
-d '{"value":"https://yourdomain.com","format":"png","size":512}'How does API authentication work?
The Pro API uses API keys in the Authorization header. The key is generated in /panel/account and is exclusive to an active Pro plan.
Add the Authorization: Bearer header with your token to every Pro request. The key is generated from /panel/account in one click and can be revoked at any time without affecting already-printed QR codes.
Example with API key
curl https://codigo-qr.es/api/v1/qr \
-H "Authorization: Bearer cqr_your_token_here"The API key requires an active Pro plan. See plans and pricing
What endpoints does the QR code API have?
Eight endpoints: one public without auth for instant generation, and seven Pro to create, list, update, delete, download images and view scan statistics.
| Method | Path | Purpose | Plan |
|---|---|---|---|
| POST | /api/v1/qr/render | Generates a QR and returns the image in base64. No auth. | Public |
| GET | /api/v1/qr | Lists all your QR codes with pagination. | Pro |
| POST | /api/v1/qr | Creates a static or dynamic QR code. | Pro |
| GET | /api/v1/qr/{id} | Returns the full detail of a QR code. | Pro |
| PATCH | /api/v1/qr/{id} | Updates the destination, name or status. | Pro |
| DELETE | /api/v1/qr/{id} | Deletes a QR code (soft delete, reversible). | Pro |
| GET | /api/v1/qr/{id}/image | Downloads the PNG or SVG image of the QR code. | Pro |
| GET | /api/v1/qr/{id}/stats | Scan statistics by day and by country. | Pro |
What is the QR API used for in a business?
E-commerce, restaurants, events and logistics use it to automate QR generation in documents and systems, with no manual intervention.
E-commerce
The ERP generates a QR per delivery note with the tracking URL. If the URL changes, PATCH updates the destination without reprinting.
Restaurants
The POS creates a QR per table at the start of a shift. The chef updates the menu in the CMS; the QR always redirects to the current version.
Events
The ticketing system generates a unique QR per ticket. At the door, the scanner verifies the QR via the API and confirms whether it is valid.
Logistics
Each package has a QR pointing to its tracking page. Scans are recorded in GET /api/v1/qr/{id}/stats.
How many requests does the QR API allow?
The public endpoint accepts 50 requests per day per IP. Pro endpoints allow 60 requests per minute per user with an API key.
When you exceed the limit the API returns 429 with the X-RateLimit-Limit, X-RateLimit-Remaining and Retry-After headers so you know when to retry.
Public
50
req / day / IP
Pro
60
req / min / user
Frequently asked questions about the QR API
The public endpoint is free, limited to 50 requests per day per IP. The full API, with API key, CRUD, image and stats, requires a Pro plan at €5.99/month.
PNG and SVG. Use the format=png or format=svg parameter. Available sizes are 256, 512 and 1024 pixels.
Yes. PATCH /api/v1/qr/{id} updates the destination URL at any time. The printed QR code stays the same; only the destination changes.
Only the SHA-256 hash of the token is stored, never the token itself. It is shown once when generated. You can revoke the key from /panel/account at any time.
Not yet. The API is standard REST and works with any HTTP client: curl, fetch, axios, Python requests, PHP Guzzle and similar.
Start integrating the QR API today
Create your account, activate the Pro plan and generate your first API key in under 2 minutes.