Download QR Code

Download a QR code image

curl --request GET \
  --url https://api.scanova.io/qr/{qrid}/download/ \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.scanova.io/qr/{qrid}/download/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.scanova.io/qr/{qrid}/download/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.scanova.io/qr/{qrid}/download/"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.scanova.io/qr/{qrid}/download/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

GET

{qrid}

download

Download a QR code image

curl --request GET \
  --url https://api.scanova.io/qr/{qrid}/download/ \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.scanova.io/qr/{qrid}/download/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.scanova.io/qr/{qrid}/download/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.scanova.io/qr/{qrid}/download/"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.scanova.io/qr/{qrid}/download/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

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`)

Returned file will match the requested format and size.

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

Authorization

string

header

required

Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: YOUR_API_KEY. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.

Path Parameters

qrid

string

required

The QR code's qrid — the opaque public identifier returned by the list endpoint, not the numeric id.

Query Parameters

size

integer

default:300

Output size in pixels, from 10 to 2400.

for_print

boolean

default:false

Return a print-ready PDF, generated locally rather than via the generator service.

file

enum<string>

Output format.

Available options:

png,

jpg,

jpeg,

svg,

pdf,

eps,

ps

info

string

Pre-computed encode payload override, for static categories whose client-side encoding the backend does not reproduce.

Response

The rendered image, as a binary attachment.

Getting Started

Reference

QR Code Management

Folder Management

Form Management

Lead List Management

User Management

Analytics & Reporting

Path Parameter

Query Parameters

Examples

Download QR Code with Default Size

Download in Different Formats

Download QR Code with Custom Size

Download with Different Sizes for Different Use Cases

Download for Print

Successful Responses

Example Outputs by Format

Error Handling

Invalid Size Parameter

QR Code Not Found

Best Practices

Authorizations

Path Parameters

Query Parameters

Response

​

​Path Parameter

​Query Parameters

​Examples

​Download QR Code with Default Size

​Download in Different Formats

​Download QR Code with Custom Size

​Download with Different Sizes for Different Use Cases

​Download for Print

​Successful Responses

​Example Outputs by Format

​Error Handling

​Invalid Size Parameter

​QR Code Not Found

​Best Practices

Authorizations

Path Parameters

Query Parameters

Response

Path Parameter

Query Parameters

Examples

Download QR Code with Default Size

Download in Different Formats

Download QR Code with Custom Size

Download with Different Sizes for Different Use Cases

Download for Print

Successful Responses

Example Outputs by Format

Error Handling

Invalid Size Parameter

QR Code Not Found

Best Practices