Skip to main content
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

NameTypeRequiredDescription
qridstring✅Unique QR Code identifier (e.g., Q3493df1c0e074ac7)

​
Query Parameters

NameTypeRequiredDefaultDescription
formatstringNopngOutput file format. Supported values: png, jpg, pdf, svg, eps
sizeintegerNo300Image width and height in pixels (min: 10, max: 1000)

​
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 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"

​
Successful Responses

HTTP StatusDescriptionResponse Type
200 OKQR Code downloaded successfullyBinary file (image/png, image/jpeg, application/pdf, image/svg+xml, application/postscript)
Returned file will match the requested format and size.

​
Example Outputs by Format

FormatMIME TypeDescription
pngimage/pngHigh-quality raster image (default, recommended for general use)
jpgimage/jpegCompressed raster image (smaller file size)
pdfapplication/pdfPrintable vector format
svgimage/svg+xmlScalable vector graphic (editable in Illustrator/Figma)
epsapplication/postscriptPrint-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

​
Authorization
string
header
required

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

Path Parameters

​
qrid
string
required

QR Code ID

Query Parameters

​
format
enum<string>
default:png

Download format

Available options:
png,
jpg,
pdf,
svg,
eps
​
size
integer
default:300

Size of the QR code image in pixels (width and height). Must be between 10 and 1000 pixels.

Required range: 10 <= x <= 1000

Response

QR Code file

The response is of type file.