Skip to main content

Get Branding Theme

Retrieve one branding theme by id. Built-in dashboard palettes, themes on another store, and deleted themes return 404.

Request​

GET /branding-themes/{id}

Path Parameters​

ParameterTypeRequiredDescription
idstringYesBranding theme UUID.

Example Request​

curl -X GET "https://cart.easy.tools/api/v1/branding-themes/f670a72a-7a46-4853-9ebb-91ddf691358e" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Response​

Success Response (200)​

{
  "id": "f670a72a-7a46-4853-9ebb-91ddf691358e",
  "name": "Studio",
  "is_default": true,
  "font": null,
  "logo_url": "https://cdn.example.com/branding/studio-logo.png",
  "logo_square_url": null,
  "brand_color": "#101828",
  "background_color": "#f9fafb",
  "text_color": "#101828",
  "card_background_color": "#ffffff",
  "card_text_color": "#101828",
  "border_color": "#d0d5dd"
}

See Branding Theme Object.

Error Responses​

Bad Request (400)​

{
  "message": "Invalid branding theme ID"
}

Returned when the path UUID is malformed.

Not Found Error (404)​

{
  "message": "Branding theme with ID f670a72a-7a46-4853-9ebb-91ddf691358e not found"
}

Unauthorized Error (401)​

{
  "message": "Unauthenticated."
}

Forbidden Error (403)​

{
  "message": "You do not have API access to the requested store."
}