List Survey Themes
Returns a paginated list of all themes in your account's theme library.
Endpoint
GET
v5/surveytheme
Requires authentication
Path Parameters
This endpoint does not include path parameters.
None
Query Parameters
All query parameters are optional.
page
integer
Page number to return. Defaults to 1.
resultsperpage
integer
Number of results to return per page. Default is 50, maximum is 500.
Response
Returns a keyed object of survey theme objects, where each key is the theme ID.
result_ok
boolean
Whether the request succeeded.
data
object
Keyed object of theme objects, where each key is the theme's numeric ID.
child attributes
id
integer
The unique ID of the theme.
status
string
The theme's status. Possible value:
Active.created
string | null
Timestamp when the theme was created, or
null.name
string
The display name of the theme.
style_options
object
The full set of visual styling options for the theme. See Get Survey Theme for the complete list of style option fields.
Body
string
The theme's HTML template body.
css
string
Custom CSS applied to the theme.
Examples
Note GET requests are cached for 60 seconds. Repeated identical requests within that window will return cached results.
Request (cURL)
curl -X GET "https://api.alchemer.com/v5/surveytheme?api_token=YOUR_API_TOKEN&api_token_secret=YOUR_API_TOKEN_SECRET"
Response
{
"result_ok": true,
"data": {
"68962": {
"id": 68962,
"status": "Active",
"created": null,
"name": "BlueGray Theme",
"style_options": {
"body background color": "#2a98bd",
"header background color": "#bcbcbc",
"page background color": "#e9e9e9",
"accent": "#ff9a00",
"base font family": "Arial",
"base font size": "14px"
},
"Body": "<div class=\"sg-wrapper\">...</div>",
"css": "/* Write your custom CSS here */\n"
}
}
}