curl "https://api.scanova.io/page-template/?category=website-url" \
-H "Authorization: YOUR_API_KEY"
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"id": 3,
"name": "Product Launch",
"slug": "product-launch-a1b2c3",
"description": "A landing page for launches.",
"category": { "id": 5, "slug": "website-url", "name": "Website URL" },
"theme": {
"id": 7,
"name": "Ocean Breeze",
"slug": "user-42-ocean-breeze-a1b2c3",
"description": "A cool blue palette.",
"config_json": { "color": { "accent": "#0077be", "background": "#f0f8ff" } },
"schema_version": 2,
"category_hints": ["website-url"],
"thumbnail_url": "https://cdn.scanova.io/themes/7/thumb.png",
"is_system": false,
"is_premium": false,
"order": 0
},
"blocks_json": [{ "type": "hero" }],
"filter_tags": ["business", "launch"],
"accent_color": "#0077be",
"preview_bg": "#f0f8ff",
"thumbnail_url": "https://cdn.scanova.io/page-templates/3/thumb.png",
"is_premium": false,
"is_system": true,
"is_favourited": false,
"order": 0
}
]
}
Themes & Page Templates
List page templates
GET /page-template/
GET
/
page-template
/
curl "https://api.scanova.io/page-template/?category=website-url" \
-H "Authorization: YOUR_API_KEY"
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"id": 3,
"name": "Product Launch",
"slug": "product-launch-a1b2c3",
"description": "A landing page for launches.",
"category": { "id": 5, "slug": "website-url", "name": "Website URL" },
"theme": {
"id": 7,
"name": "Ocean Breeze",
"slug": "user-42-ocean-breeze-a1b2c3",
"description": "A cool blue palette.",
"config_json": { "color": { "accent": "#0077be", "background": "#f0f8ff" } },
"schema_version": 2,
"category_hints": ["website-url"],
"thumbnail_url": "https://cdn.scanova.io/themes/7/thumb.png",
"is_system": false,
"is_premium": false,
"order": 0
},
"blocks_json": [{ "type": "hero" }],
"filter_tags": ["business", "launch"],
"accent_color": "#0077be",
"preview_bg": "#f0f8ff",
"thumbnail_url": "https://cdn.scanova.io/page-templates/3/thumb.png",
"is_premium": false,
"is_system": true,
"is_favourited": false,
"order": 0
}
]
}
Lists page templates, on
By default this is the system template gallery (
api.scanova.io, authenticated with your raw API key.
GET https://api.scanova.io/page-template/
Authorization: YOUR_API_KEY
boolean
List only the caller’s own templates instead of the system gallery — unpaginated, newest-modified first. Empty for unauthenticated calls.
string
Filter the system gallery to templates whose tags include this QR category slug. Only applies when
mine isn’t set.string
Search template name/description.
integer
Page number.
integer
Results per page, max 100.
curl "https://api.scanova.io/page-template/?category=website-url" \
-H "Authorization: YOUR_API_KEY"
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"id": 3,
"name": "Product Launch",
"slug": "product-launch-a1b2c3",
"description": "A landing page for launches.",
"category": { "id": 5, "slug": "website-url", "name": "Website URL" },
"theme": {
"id": 7,
"name": "Ocean Breeze",
"slug": "user-42-ocean-breeze-a1b2c3",
"description": "A cool blue palette.",
"config_json": { "color": { "accent": "#0077be", "background": "#f0f8ff" } },
"schema_version": 2,
"category_hints": ["website-url"],
"thumbnail_url": "https://cdn.scanova.io/themes/7/thumb.png",
"is_system": false,
"is_premium": false,
"order": 0
},
"blocks_json": [{ "type": "hero" }],
"filter_tags": ["business", "launch"],
"accent_color": "#0077be",
"preview_bg": "#f0f8ff",
"thumbnail_url": "https://cdn.scanova.io/page-templates/3/thumb.png",
"is_premium": false,
"is_system": true,
"is_favourited": false,
"order": 0
}
]
}
is_system: true, 20 per page, sorted favourited-first then by order). Pass ?mine=true to switch to your own templates instead — note the response shape stays the same but pagination/sorting differs as described above.
Related
- Create a page template — save a new one.
- List page template tags — see what
category/tag values exist across the gallery. - Favourite a page template — toggle
is_favouritedfor a template. - API overview — the auth scheme and quota rules that apply to this endpoint.
Authorizations
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.
Query Parameters
List only the caller's own templates instead of the system gallery.
Filter the system gallery to templates whose filter_tags include this category slug.
Search template name/description.
Max 100.
Response
200 - application/json
Paginated list of page templates.
Was this page helpful?