Get a theme

Retrieve a single theme by ID.

GET /v1/themes/{themeId}

Get a theme

cURL

curl --request GET \
  --url https://app.loops.so/api/v1/themes/{themeId} \
  --header 'Authorization: Bearer <token>'

Response

{
  "success": true,
  "themeId": "thm_01hxyz",
  "name": "Marketing default",
  "styles": {
    "backgroundColor": "#ffffff",
    "textBaseColor": "#111111",
    "textBaseFontSize": 16
  },
  "isDefault": true,
  "createdAt": "2026-03-28T15:00:00.000Z",
  "updatedAt": "2026-03-28T15:00:00.000Z"
}

Content API endpoints are currently in an open alpha and are subject to change.

Request

Path parameters

themeId · string · required

The ID of the theme.

Response

Success

success · boolean · required

themeId · string · required

The theme ID.

name · string · required

The theme name.

styles · object · required

The theme’s style attributes. Attributes use the same names as the LMX <Style /> tag attributes.

isDefault · boolean · required

Whether this theme is the team’s default theme.

createdAt · string · required

ISO 8601 timestamp for when the theme was created.

updatedAt · string · required

ISO 8601 timestamp for when the theme was last updated.

Error

A 400 Bad Request is returned if themeId is invalid.

A 404 Not Found is returned if the theme does not exist.

If the API key is invalid (or content API is not enabled for your team), a 401 Unauthorized is returned.

success · boolean · required

message · string · required

Response

{
  "success": true,
  "themeId": "thm_01hxyz",
  "name": "Marketing default",
  "styles": {
    "backgroundColor": "#ffffff",
    "textBaseColor": "#111111",
    "textBaseFontSize": 16
  },
  "isDefault": true,
  "createdAt": "2026-03-28T15:00:00.000Z",
  "updatedAt": "2026-03-28T15:00:00.000Z"
}