Skip to main content

​
QR Code Categories Reference

When creating QR Codes through the Scanova API, you must specify a Category ID that defines the type of QR Code you want to create — such as a website link, event, social media profile, or document. This page provides a complete list of available categories, along with examples for how to use them in your API requests.

​
Available Categories

Category IDCategory NameSlugDescription
1Website URLurlWhen scanned, redirects user to a website
11Google MapmapWhen scanned, shows location on Google Maps
13DocumentdocumentWhen scanned, redirects user to uploaded documents
38Business CardbusinessCardWhen scanned, displays business card information
19ImageimageWhen scanned, user can view or download images
27AudioaudioWhen scanned, plays audio content
15Social MediasMediaWhen scanned, displays links to social media profiles
44RestaurantrestaurantWhen scanned, displays restaurant menu and details
18ProductproductWhen scanned, displays detailed information about the product
14WeddingweddingWhen scanned, displays wedding details and RSVP option
20EventeventWhen scanned, displays event details and RSVP option
10App StoreappStoreWhen scanned, redirects to app store for download
23App Deep LinkappDeepLinkWhen scanned, opens the app directly
28CouponcouponWhen scanned, displays coupon information
9Custom PagedynamicTextWhen scanned, displays a customized mobile landing page

​
How to Use Categories

​
Include Category ID in Your Request

When creating a QR Code, pass the category parameter with the appropriate ID in your request body. 
curl -X POST "https://management.scanova.io/qrcode/" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "category": "1",
    "info": "{\"type\":\"url\",\"data\":{\"url\":\"https://example.com\"}}",
    "qr_type": "dy",
    "name": "My Website QR Code"
  }'

​
Category-Specific Info Format

Each category has a unique structure for the info field.
Below are examples of commonly used formats:

​
Website URL (ID: 1)

{
  "type": "url",
  "data": {
    "url": "https://example.com"
  }
}
Redirects users directly to the specified URL when scanned.

​
Google Map (ID: 11)

{
  "type": "location",
  "data": {
    "place_name": "Central Park, New York",
    "latitude": "40.7829",
    "longitude": "-73.9654"
  }
}
Displays the given location on Google Maps.

​
Document (ID: 13)

{
  "type": "documents",
  "data": [
    {
      "url": "https://example.com/document.pdf",
      "name": "Document Name"
    }
  ]
}
Opens or downloads one or more attached documents

​
Social Media (ID: 15)

{
  "type": "page_layout",
  "data": {
    "backgroundColor": "#ffffff",
    "socialLinks": [
      {
        "platform": "facebook",
        "url": "https://facebook.com/yourpage"
      },
      {
        "platform": "twitter",
        "url": "https://twitter.com/yourhandle"
      }
    ]
  }
}
Displays a mobile-friendly page linking to multiple social profiles

​
Getting Category Information

You can fetch the complete list of categories through the API: 
curl -X GET "https://management.scanova.io/qrcode/category/" \
  -H "Authorization: Bearer YOUR_API_KEY"
Response includes:
  • Category ID and name
  • Description and use case
  • Supported QR code types
  • Preview images and tags

​
Best Practices

All QR Codes created through the Scanova API are Dynamic by default "qr_type": "dy"), allowing you to update their content anytime without changing the printed QR code.

​
Category Limitations

  • Each category requires a specific info JSON format.
  • Some categories include extra styling or layout options.
  • All categories support Dynamic QR Codes (editable after creation).

​
Need Help?

If you’re unsure which category to use for your specific use case, check out our API examples or contact our support team.