curl "https://api.scanova.io/theme/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"
[
{
"id": 7,
"name": "Ocean Breeze",
"slug": "user-42-ocean-breeze-a1b2c3",
"description": "A cool blue palette.",
"config_json": { "color": { "accent": "#0077be", "background": "#f0f8ff" }, "font": { "heading": "Inter" } },
"schema_version": 2,
"category_hints": ["website-url", "vcard"],
"thumbnail_url": "https://cdn.scanova.io/themes/7/thumb.png",
"is_system": false,
"is_premium": false,
"order": 0
}
]
Themes & Page Templates
List themes
GET /theme/
GET
/
theme
/
curl "https://api.scanova.io/theme/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"
[
{
"id": 7,
"name": "Ocean Breeze",
"slug": "user-42-ocean-breeze-a1b2c3",
"description": "A cool blue palette.",
"config_json": { "color": { "accent": "#0077be", "background": "#f0f8ff" }, "font": { "heading": "Inter" } },
"schema_version": 2,
"category_hints": ["website-url", "vcard"],
"thumbnail_url": "https://cdn.scanova.io/themes/7/thumb.png",
"is_system": false,
"is_premium": false,
"order": 0
}
]
Lists every active theme, on the Management API host (
api.scanova.io), authenticated with your raw Management API key.
GET https://api.scanova.io/theme/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
Themes are a shared-read resource for the page builder — this returns system themes plus every account’s own themes, not just yours. Not paginated; the response is a plain array. System themes (
is_system: true) sort first, then by order, then name.curl "https://api.scanova.io/theme/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"
[
{
"id": 7,
"name": "Ocean Breeze",
"slug": "user-42-ocean-breeze-a1b2c3",
"description": "A cool blue palette.",
"config_json": { "color": { "accent": "#0077be", "background": "#f0f8ff" }, "font": { "heading": "Inter" } },
"schema_version": 2,
"category_hints": ["website-url", "vcard"],
"thumbnail_url": "https://cdn.scanova.io/themes/7/thumb.png",
"is_system": false,
"is_premium": false,
"order": 0
}
]
config_json follows the ThemeConfigV2 schema (colors, fonts, and other design tokens); schema_version is null for legacy v1 themes and 2 for current ones.
Related
- Create a theme — save a new one.
- Retrieve a theme — fetch one by slug or id.
- Update a theme — edit one you own.
- Management 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: 401f7ac837da42b97f613d789819ff93537bee6a. 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.
Response
200 - application/json
Plain array of themes.
Was this page helpful?