Skip to main content
POST
Create QR Code
Try it dropdowns: The category dropdown shows IDs (1, 9, 10, …). qr_type shows dy / st. Use the tables below to match values to labels.

Request Body — Fields

Required fields

Category dropdown reference (Try it)

qr_type dropdown reference (Try it)

Optional / Advanced fields
Note: Advanced features (custom domains, geo-fencing, lead capture, expiry) may require specific plan quotas or entitlements.

Authorizations

Authorization
string
header
required

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

Body

application/json
category
enum<integer>
required

QR Code Category ID. See Category List for full reference. In Try it: 1=Website URL, 9=Custom Page, 10=App Store, 11=Google Map, 13=Document, 14=Wedding, 15=Social Media, 16=Audio, 17=Coupon, 18=Product, 19=Image, 20=Event, 23=App Deep Link, 24=Business Card, 25=Restaurant, 26=Feedback, 27=Real Estate, 28=Link Page, 31=GS1, 44=Restaurant.

Available options:
1,
9,
10,
11,
13,
14,
15,
16,
17,
18,
19,
20,
23,
24,
25,
26,
27,
28,
31,
44
Example:

1

info
string
required

JSON data to create QR code. See Components Reference for detailed structure examples for each category.

Example:

"{\"type\":\"url\",\"data\":{\"url\":\"https://example.com\"}}"

name
string
required

Name of the QR Code

Example:

"My Website QR Code"

qr_type
enum<string>
required

QR code type. In Try it: dy=Dynamic (editable after creation), st=Static (fixed content).

Available options:
dy,
st
Example:

"dy"

pattern_info
string

JSON data to create design QR Code (optional). See Pattern Info Reference for complete customization options and field values.

Example:

"{\"dataInfo\":{\"pattern\":\"lightSquare\",\"gradientStyle\":\"Diagonal\",\"startColor\":\"#000\",\"endColor\":\"#000\",\"logo\":null},\"backGroundColor\":\"#ffffff\",\"eyeInfo\":{\"TL\":{\"innerEyeColor\":\"#000\",\"outerEyeColor\":\"#000\",\"shape\":\"Shape4\"},\"TR\":{\"innerEyeColor\":\"#000\",\"outerEyeColor\":\"#000\",\"shape\":\"Shape4\"},\"BL\":{\"innerEyeColor\":\"#000\",\"outerEyeColor\":\"#000\",\"shape\":\"Shape4\"}},\"version\":\"1.5\",\"type\":\"qrcode\",\"frame\":{\"id\":2,\"primaryColor\":\"#FF7C7C\",\"secondaryColor\":null,\"textColor\":\"#FFFFFF\",\"bgColor\":\"#FFFFFF\",\"category\":\"url\"},\"errorCorrection\":\"Q\"}"

custom_domain
integer

Custom domain ID for the QR code (advanced feature - requires plan quota)

Example:

1903

expire_on
string<date-time>

Expiration date and time for the QR code (advanced feature - requires plan quota)

Example:

"2025-10-31T02:03:00+05:30"

expire_on_text
string

Custom HTML text to display when QR code is expired (advanced feature - requires plan quota)

Example:

"<div style=\"text-align:center\"><img alt=\"\" src=\"https://qcg-media.scanova.io/assets/landing/qr-placeholder-expired.png\" style=\"height:137px; width:150px\" /></div><p style=\"text-align:center\">This QR Code has been deactivated</p>"

expire_on_timezone
string

Timezone for expiration date (advanced feature - requires plan quota)

Example:

"Asia/Kolkata"

high_accuracy_confirmation
boolean

Enable high accuracy confirmation for location-based QR codes (advanced feature - requires plan quota)

Example:

true

high_accuracy_geo_fencing
boolean

Enable high accuracy geo-fencing for location-based QR codes (advanced feature - requires plan quota)

Example:

true

high_accuracy_geo_fencing_config
object

Configuration for high accuracy geo-fencing (advanced feature - requires plan quota)

high_accuracy_mode
boolean

Enable high accuracy mode for location-based QR codes (advanced feature - requires plan quota)

Example:

true

high_accuracy_mode_text
string

Text to display when requesting location access (advanced feature - requires plan quota)

Example:

"The QR Code administrator is requesting one-time access to your device's location. You will be redirected to the content regardless of your choice."

lead_list
integer

Lead list ID for capturing leads (advanced feature - requires plan quota)

Example:

1106

minimum_age
integer

Minimum age requirement for accessing QR code content (advanced feature - requires plan quota)

Example:

18

password
string

Password protection for QR code access (advanced feature - requires plan quota)

Example:

"123456"

Response

QR Code created successfully

id
integer

Internal QR code ID

Example:

2411719

qrid
string

Unique QR code identifier

Example:

"Q3493df1c0e074ac7"

name
string

Name of the QR code

Example:

"QR Code"

qr_type
string

QR code type

Example:

"dy"

qr_type_display
string

Human-readable QR code type

Example:

"Dynamic"

category
object
info
string

JSON data for QR code content

Example:

"{\"type\":\"url\",\"data\":{\"url\":\"https://scanova.io\"}}"

dynamic_url_object
object
pattern_info
string

QR code design pattern information

Example:

null

svg_code
string

SVG code for QR code

Example:

null

thumbnail
string

Thumbnail URL for QR code

Example:

null

is_active
boolean

Whether the QR code is active

Example:

true

version
number

QR code version

Example:

1

created
string<date-time>

Creation timestamp

Example:

"2025-10-24T18:54:22.697338+05:30"

modified
string<date-time>

Last modification timestamp

Example:

"2025-10-24T18:54:22.697362+05:30"

tags_list
string[]

List of tags associated with QR code

Example:
is_password_protected
boolean

Whether the QR code is password protected

Example:

false

is_age_restricted
boolean

Whether the QR code has age restrictions

Example:

false

is_designer
boolean

Whether the QR code uses designer features

Example:

false

pattern_type
string

Pattern type for QR code design

Example:

null

created_by
string

User who created the QR code

Example:

null

password
string

Password for QR code access

Example:

null

ai_qr_code
string

AI-generated QR code information

Example:

null

wallet_pass_info
string

Wallet pass information

Example:

null

is_qr_scannable
boolean

Whether the QR code is scannable

Example:

null

custom_form_response_count
integer

Number of custom form responses

Example:

0

rsvp_form_response_count
integer

Number of RSVP form responses

Example:

0

restaurant_feedback_response_count
integer

Number of restaurant feedback responses

Example:

0