---
title: "Get the Active Theme"
method: GET
path: "/v1/tenants/{tenant_id}/realms/{realm_id}/themes/active"
tags: ["Themes"]
---

# Get the Active Theme

`GET /v1/tenants/{tenant_id}/realms/{realm_id}/themes/active`

## Request

- Base URL: `https://api-us.beyondidentity.com`
- URL: `https://api-us.beyondidentity.com/v1/tenants/{tenant_id}/realms/{realm_id}/themes/active`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/beyondidentity/apis/beyond-identity-secure-access-api/docs/v1/tenants/:tenant_id/realms/:realm_id/themes/active/get.ts> (a function with typed inputs; its response is checked against the schema)

To retrieve the active theme for a realm, send a GET request to `/v1/tenants/$TENANT_ID/realms/$REALM_ID/themes/active`. If the realm has not specified the active theme, a default theme will be returned.

## Path parameters

- `tenant_id` string, required
- `realm_id` string, required

## Response `200`

The response will be a JSON object containing the standard attributes associated with a theme.

- Theme: A theme is a collection of configurable assets that unifies the end user login experience with your brand and products. It is primarily used to change the styling of the credential binding email.
  - `id` string: A unique identifier for a theme. This is automatically generated on creation. This field is immutable and read-only. This field is unique within the realm.
  - `tenant_id` string: A unique identifier for the theme's tenant. This is automatically set on creation. This field is immutable and read-only.
  - `realm_id` string: A unique identifier for the theme's realm. This is automatically set on creation. This field is immutable and read-only.
  - `create_time` string, date-time: Timestamp of when the theme was created. This field is immutable and read-only.
  - `update_time` string, date-time: Timestamp of when the theme was last updated. This field is read-only.
  - `email_realm_name` string: Realm name that is used in email templates.
  - `logo_url_light` string: URL for resolving the logo image for light mode.
  - `logo_url_dark` string: URL for resolving the logo image for dark mode.
  - `support_url` string, url: URL for the customer support portal.
  - `button_color` string: Hexadecimal color code to use for buttons.
  - `button_text_color` string: Hexadecimal color code to use for button text.

## Other responses

- `401`: Unauthorized.
- `403`: Forbidden.
- `404`: The resource was not found.
- `500`: Server error.

---

[API](https://skmtc.dev/beyondidentity/apis/beyond-identity-secure-access-api.md) - [All operations](https://skmtc.dev/beyondidentity/apis/beyond-identity-secure-access-api/llms.txt) - [OpenAPI document](https://skmtc.dev/beyondidentity/apis/beyond-identity-secure-access-api/revisions/42f3cac49392?raw)