Download QR Code
curl --request GET \
--url https://management.scanova.io/qr/{qrid}/download/ \
--header 'Authorization: <api-key>'"<string>"QR Code Management
Download QR Code
Download a QR Code image in multiple formats (PNG, JPG, PDF, SVG, EPS) with a customizable size. The size parameter defines both the width and height in pixels (range: 10–1000, default: 300). Authentication required.
GET
/
qr
/
{qrid}
/
download
Download QR Code
curl --request GET \
--url https://management.scanova.io/qr/{qrid}/download/ \
--header 'Authorization: <api-key>'"<string>"Path Parameter
| Name | Type | Required | Description |
|---|---|---|---|
qrid | string | ✅ | Unique QR Code identifier (e.g., Q3493df1c0e074ac7) |
Query Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
file | string | No | png | Output file format. Supported values: png, jpg, pdf, svg, eps |
size | integer | No | 300 | Image width and height in pixels (min: 10, max: 1000) |
for_print | boolean | No | false | When true, returns a print-optimized QR code (e.g. black and white, suitable for professional printing). |
Examples
Download QR Code with Default Size
curl -X GET "https://management.scanova.io/qr/Q3493df1c0e074ac7/download/" \
-H "Authorization: YOUR_API_KEY" \
-o "qr-code.png"
Download in Different Formats
# Download as PNG (default)
curl -X GET "https://management.scanova.io/qr/Q3493df1c0e074ac7/download/?file=png" \
-H "Authorization: YOUR_API_KEY" \
-o "qr-code.png"
# Download as PDF
curl -X GET "https://management.scanova.io/qr/Q3493df1c0e074ac7/download/?file=pdf" \
-H "Authorization: YOUR_API_KEY" \
-o "qr-code.pdf"
# Download as SVG
curl -X GET "https://management.scanova.io/qr/Q3493df1c0e074ac7/download/?file=svg" \
-H "Authorization: YOUR_API_KEY" \
-o "qr-code.svg"
Download QR Code with Custom Size
# Download 500x500 pixel QR code
curl -X GET "https://management.scanova.io/qr/Q3493df1c0e074ac7/download/?size=500" \
-H "Authorization: YOUR_API_KEY" \
-o "qr-code-500px.png"
# Download small 100x100 pixel QR code
curl -X GET "https://management.scanova.io/qr/Q3493df1c0e074ac7/download/?size=100" \
-H "Authorization: YOUR_API_KEY" \
-o "qr-code-small.png"
# Download large 1000x1000 pixel QR code
curl -X GET "https://management.scanova.io/qr/Q3493df1c0e074ac7/download/?size=1000" \
-H "Authorization: YOUR_API_KEY" \
-o "qr-code-large.png"
Download with Different Sizes for Different Use Cases
# Small size for web thumbnails
curl -X GET "https://management.scanova.io/qr/Q3493df1c0e074ac7/download/?size=150" \
-H "Authorization: YOUR_API_KEY" \
-o "qr-thumbnail.png"
# Medium size for print materials
curl -X GET "https://management.scanova.io/qr/Q3493df1c0e074ac7/download/?size=300" \
-H "Authorization: YOUR_API_KEY" \
-o "qr-print.png"
# Large size for high-resolution displays
curl -X GET "https://management.scanova.io/qr/Q3493df1c0e074ac7/download/?size=800" \
-H "Authorization: YOUR_API_KEY" \
-o "qr-hd.png"
Download for Print
# Print-optimized QR code (black and white, suitable for professional printing)
curl -X GET "https://management.scanova.io/qr/Q3493df1c0e074ac7/download/?for_print=true" \
-H "Authorization: YOUR_API_KEY" \
-o "qr-print-ready.png"
# Print-optimized with custom size
curl -X GET "https://management.scanova.io/qr/Q3493df1c0e074ac7/download/?for_print=true&size=300" \
-H "Authorization: YOUR_API_KEY" \
-o "qr-print-300px.png"
Successful Responses
| HTTP Status | Description | Response Type |
|---|---|---|
200 OK | QR Code downloaded successfully | Binary file (image/png, image/jpeg, application/pdf, image/svg+xml, application/postscript) |
Example Outputs by Format
| Format | MIME Type | Description |
|---|---|---|
png | image/png | High-quality raster image (default, recommended for general use) |
jpg | image/jpeg | Compressed raster image (smaller file size) |
pdf | application/pdf | Printable vector format |
svg | image/svg+xml | Scalable vector graphic (editable in Illustrator/Figma) |
eps | application/postscript | Print-ready format (for professional printing) |
Error Handling
Invalid Size Parameter
If the size parameter is outside the allowed range (10-1000), the API will return an error:{
"error": "Invalid size parameter",
"message": "Size must be between 10 and 1000 pixels"
}
QR Code Not Found
If the QR code ID doesn’t exist:{
"error": "Not found",
"message": "QR code not found"
}
Best Practices
- Use SVG or EPS for scalable, high-resolution print or design work.
- Use PNG for digital and web usage.
- Avoid extremely large sizes (>800px) unless required — larger images increase load times and API latency.
- Protect API keys: store keys securely in environment variables, not directly in scripts.
- For bulk downloads, loop over QR IDs with a delay or queue to avoid hitting rate limits.
Authorizations
API key authentication. Enter your API key directly in the Authorization header.
Path Parameters
QR Code ID
Query Parameters
Download format
Available options:
png, jpg, pdf, svg, eps Size of the QR code image in pixels (width and height). Must be between 10 and 1000 pixels.
Required range:
10 <= x <= 1000When true, returns a print-optimized QR code (e.g. black and white, suitable for professional printing).
Response
QR Code file
The response is of type file.
Was this page helpful?
⌘I