Themes

Retrieve themes

get
https://api.typeform.com/themes

Retrieves a list of JSON descriptions for all themes in your Typeform account (public and private). Themes are listed in reverse-chronological order based on the date you added them to your account.

Request

Query Parameters

page
integer

The page of results to retrieve. Default 1 is the first page of results.

page_size
number

Number of results to retrieve per page. Default is 10. Maximum is 200.

Response

Status

200 OK

Schema

List of themes.

page_count
number

Number of pages.

total_items
number

Total number of items in the retrieved collection.

items Path 3
array of object
background Path 3
object

Settings for the background.

brightness
number

Brightness for the background. -1 is least bright (minimum) and 1 is most bright (maximum).

href
string

Background image URL.

layout
string
Valid values:fullscreenrepeatno-repeat
Default:fullscreen

Layout for the background.

colors Path 3
object

Colors the theme will apply to answers, background, buttons, and questions.

answer
string

Color the theme will apply to answers. Hexadecimal value.

background
string

Color the theme will apply to background. Hexadecimal value.

button
string

Color the theme will apply to buttons. Hexadecimal value.

question
string

Color the theme will apply to questions. Hexadecimal value.

fields Path 3
object

Defines font size and alignment for fields.

alignment
string
Valid values:leftcenter
Default:left

Fields alignment

font_size
string
Valid values:smallmediumlarge
Default:medium

Fields font size

font
string
Valid values:AcmeArialArvoAvenir NextBangersCabinCabin CondensedCourierCrete RoundDancing ScriptExoGeorgiaHandleeHelvetica NeueKarlaLatoLektonLobsterLoraMcLarenMontserratNixie OneOld Standard TTOpen SansOswaldPlayfair DisplayQuicksandRalewaySignikaSnigletSource Sans ProVollkorn
Default:Source Sans Pro

Font for the theme.

has_transparent_button
boolean

true if buttons should be transparent. Otherwise, false.

id
string

Unique ID of the theme.

name
string

Name of the theme.

rounded_corners
string
Valid values:nonesmalllarge
Default:small

Specifies border radius style of buttons and other elements in the form.

screens Path 3
object

Defines font size and alignment for welcome and thankyou screens.

alignment
string
Valid values:leftcenter
Default:center

Screen alignment

font_size
string
Valid values:smallmediumlarge
Default:small

Screen font size

visibility
string
Valid values:publicprivate
Default:private

Specifies whether the theme is public (one of Typeform's built-in themes that are available in all accounts) or private (a theme you created). You can only change private themes. You can't change Typeform's public themes.