Skip to main content
GET
/
api
/
v1
/
themes
List themes
curl --request GET \
  --url https://quizquail.com/api/v1/themes \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "primaryColor": "<string>",
      "secondaryColor": "<string>",
      "backgroundColor": "<string>",
      "textColor": "<string>",
      "accentColor": "<string>",
      "fontFamily": "<string>",
      "backgroundImageUrl": "<string>",
      "isPublic": true,
      "effects": {
        "backgroundImageOpacity": 0.4,
        "backgroundStyle": "blobs",
        "backgroundBlobCount": 3,
        "backgroundBlobOpacity": 0.24,
        "backgroundAnimationSpeed": 1,
        "backgroundGradientIntensity": 0.13,
        "backgroundVignetteIntensity": 0.7,
        "gradientAngle": 135,
        "gradientAnimation": true,
        "backgroundPattern": "none",
        "backgroundPatternOpacity": 0.12,
        "backgroundPatternScale": 1,
        "particleStyle": "none",
        "particleDensity": 0.3,
        "particleSpeed": 1,
        "particleColor": "theme",
        "optionCardVariant": "standard",
        "optionCardOpacity": 0.33,
        "optionStripeWidth": 4,
        "titleLetterSpacing": "-0.02em",
        "textStyle": "solid",
        "titleTextStyle": "solid",
        "textShadowStyle": "subtle",
        "optionFontWeight": 400,
        "frameStyle": "none",
        "frameColor": "#FFFFFF",
        "frameOpacity": 0.5,
        "introRingCount": 3,
        "introParticleCount": 8,
        "outroConfettiCount": 12,
        "outroBurstCount": 3,
        "celebrationStyle": "pulse",
        "celebrationIntensity": 0.7,
        "correctAnswerGlowSize": 30,
        "revealSuspenseFrames": 45,
        "revealDimIntensity": 0.3,
        "urgencyStyle": "vignette",
        "urgencyThreshold": 3,
        "urgencyColor": "#EF4444",
        "transitionStyle": "fade",
        "grainOverlay": "none",
        "grainStyle": "film",
        "audioReactive": false,
        "audioReactiveIntensity": 0.5,
        "audioReactiveBpm": 120
      },
      "userId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "soundPack": "<unknown>"
    }
  ],
  "pagination": {
    "cursor": "<string>",
    "hasMore": true,
    "total": 123
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.quiz-quail.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

API key authentication. Prefix your key with Bearer in the Authorization header.

Keys follow the format qq_... and can be scoped to specific permissions.

Query Parameters

cursor
string

Pagination cursor from a previous response

limit
integer
default:20

Number of items per page (1-100, default 20)

Required range: 1 <= x <= 100
includePublic
string

Include public themes (default: true)

Response

200 - application/json

Paginated list of themes

data
object[]
required
pagination
object
required