Skip to main content
POST
/
qr
/
download
curl --request POST \
  --url https://management.scanova.io/qr/download/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: multipart/form-data' \
  --form qrid=Q184ebe392f46414a \
  --form for_print=true \
  --form name=qrCode.pdf
"<string>"

​
Description

This endpoint generates a high-quality, print-ready QR Code in PDF format, specifically designed for offset or laser printing.
The output file is optimized for grayscale printing with strict CMYK color control (black only).

​
Request Parameters

​
Form Data (multipart/form-data)

NameTypeRequiredDescription
qridstring✅Unique QR Code ID (e.g., Q184ebe392f46414a)
for_printstring✅Must be set to 'true' to enable printable mode
namestringNoOutput filename for the downloaded PDF (e.g., qrCode.pdf)
sizestringNoQR code size in pixels (range 300–600px, default 600)

​
Notes

  • The generated QR Code is vector-based (PDF) — ideal for professional printing.
  • All colors are automatically converted to pure black (K:100) for print efficiency.
  • The endpoint ignores any existing design styles — the QR is output in plain black and white for best scannability.
  • Minimum size: 300 pixels; Maximum size: 600 pixels
  • Default size: 600×600 pixels.
  • File output type: application/pdf.Request Body (Form Data)

​
Examples

​
Download Printable QR Code (Default Size)

curl -X POST "https://management.scanova.io/qr/download/" \
  -H "Authorization: YOUR_API_KEY" \
  -F "qrid=Q184ebe392f46414a" \
  -F "for_print=true" \
  -F "name=qrCode.pdf"

​
Download Printable QR Code (Custom Size)

# Download 400px printable QR code
curl -X POST "https://management.scanova.io/qr/download/" \
  -H "Authorization: YOUR_API_KEY" \
  -F "qrid=Q184ebe392f46414a" \
  -F "for_print=true" \
  -F "size=400" \
  -F "name=qrCode-400px.pdf"

# Download 300px printable QR code
curl -X POST "https://management.scanova.io/qr/download/" \
  -H "Authorization: YOUR_API_KEY" \
  -F "qrid=Q184ebe392f46414a" \
  -F "for_print=true" \
  -F "size=300" \
  -F "name=qrCode-300px.pdf"

​
Download with Different File Names

# Business card QR code
curl -X POST "https://management.scanova.io/qr/download/" \
  -H "Authorization: YOUR_API_KEY" \
  -F "qrid=Q184ebe392f46414a" \
  -F "for_print=true" \
  -F "size=300" \
  -F "name=business-card-qr.pdf"

# Poster QR code
curl -X POST "https://management.scanova.io/qr/download/" \
  -H "Authorization: YOUR_API_KEY" \
  -F "qrid=Q184ebe392f46414a" \
  -F "for_print=true" \
  -F "size=600" \
  -F "name=poster-qr.pdf"

​
Error Handling

​
Invalid Size Parameter

If the size parameter is outside the allowed range (300-600), the API will return an error: 
{
  "error": "Invalid size parameter",
  "message": "Size must be between 300 and 600 pixels for printable format"
}

​
QR Code Not Found

If the QR code ID doesn’t exist: 
{
  "error": "Not found",
  "message": "QR code not found"
}

​
Missing Required Parameters

If for_print is not set to “true”: 
{
  "error": "Invalid parameter",
  "message": "for_print must be set to true for printable format"
}

​
Best Practices

  • ✅ Use for_print=true only when generating files for offset or large-format printing.
  • ✅ Maintain high resolution (≥400px) for print clarity.
  • ⚠️ Avoid applying design layers or colors — print mode always outputs black-only QR codes.
  • 💡 Include the name parameter to generate descriptive filenames for easy organization (e.g., event-qr-print.pdf).
  • 🔒 Store API keys securely and restrict access to authorized systems only.

​
When to Use: Printable vs Standard Download

  • Use Standard for digital applications where colors, frames, or logos are needed.
  • Use Printable when you need a print-ready, high-contrast, black-only QR code for professional printing.

Authorizations

​
Authorization
string
header
required

API key authentication. Enter your API key directly in the Authorization header.

Body

multipart/form-data
​
qrid
string
required

QR code ID

Example:

"Q184ebe392f46414a"

​
for_print
enum<string>
required

Must be set to 'true' for printable format

Available options:
true
Example:

"true"

​
name
string

Name for the downloaded file

Example:

"qrCode.pdf"

​
size
string

Size of the QR code in pixels (300-600px)

Pattern: ^[3-6][0-9]{2}$
Example:

"600"

Response

Printable QR code PDF file

The response is of type file.