---
title: "GET /accounts/{AwsAccountId}/themes/{ThemeId}"
method: GET
path: "/accounts/{AwsAccountId}/themes/{ThemeId}"
---

# GET /accounts/{AwsAccountId}/themes/{ThemeId}

`GET /accounts/{AwsAccountId}/themes/{ThemeId}`

Describes a theme.

## Path parameters

- `AwsAccountId` string, required
- `ThemeId` string, required

## Query parameters

- `version-number` integer
- `alias-name` string

## Response `200`

Success

- DescribeThemeResponse
  - `Theme` object — The information about the theme that you are describing.
    - `Arn` string — The Amazon Resource Name (ARN) of the theme.
    - `Name` string — The name that the user gives to the theme.
    - `ThemeId` string — The identifier that the user gives to the theme.
    - `Version` ThemeVersion — A version of a theme.
      - `VersionNumber` integer — The version number of the theme.
      - `Arn` string — The Amazon Resource Name (ARN) of the resource.
      - `Description` string — The description of the theme.
      - `BaseThemeId` string — The Amazon QuickSight-defined ID of the theme that a custom theme inherits from. All themes initially inherit from a default Amazon QuickSight theme.
      - `CreatedTime` string, date-time — The date and time that this theme version was created.
      - `Configuration` object — The theme configuration, which contains all the theme display properties.
        - `DataColorPalette` object — Color properties that apply to chart data colors.
          - `Colors` HexColor[] — The hexadecimal codes for the colors.
          - `MinMaxGradient` HexColor[] — The minimum and maximum hexadecimal codes that describe a color gradient.
          - `EmptyFillColor` string — The hexadecimal code of a color that applies to charts where a lack of data is highlighted.
        - `UIColorPalette` object — Color properties that apply to the UI and to charts, excluding the colors that apply to data.
          - `PrimaryForeground` string — The color of text and other foreground elements that appear over the primary background regions, such as grid lines, borders, table banding, icons, and so on.
          - `PrimaryBackground` string — The background color that applies to visuals and other high emphasis UI.
          - `SecondaryForeground` string — The foreground color that applies to any sheet title, sheet control text, or UI that appears over the secondary background.
          - `SecondaryBackground` string — The background color that applies to the sheet background and sheet controls.
          - `Accent` string — This color is that applies to selected states and buttons.
          - `AccentForeground` string — The foreground color that applies to any text or other elements that appear over the accent color.
          - `Danger` string — The color that applies to error messages.
          - `DangerForeground` string — The foreground color that applies to any text or other elements that appear over the error color.
          - `Warning` string — This color that applies to warning and informational messages.
          - `WarningForeground` string — The foreground color that applies to any text or other elements that appear over the warning color.
          - `Success` string — The color that applies to success messages, for example the check mark for a successful download.
          - `SuccessForeground` string — The foreground color that applies to any text or other elements that appear over the success color.
          - `Dimension` string — The color that applies to the names of fields that are identified as dimensions.
          - `DimensionForeground` string — The foreground color that applies to any text or other elements that appear over the dimension color.
          - `Measure` string — The color that applies to the names of fields that are identified as measures.
          - `MeasureForeground` string — The foreground color that applies to any text or other elements that appear over the measure color.
        - `Sheet` object — Display options related to sheets.
          - `Tile` object — The display options for tiles.
            - `Border` object — The border around a tile.
              - …
          - `TileLayout` object — The layout options for tiles.
            - `Gutter` object — The gutter settings that apply between tiles.
              - …
            - `Margin` object — The margin settings that apply around the outside edge of sheets.
              - …
        - `Typography` Typography — Determines the typography options.
          - `FontFamilies` Font[] — Determines the list of font families.
            - `FontFamily` string — Determines the font family settings.
      - `Errors` ThemeError[] — Errors associated with the theme.
        - `Type` 'INTERNAL_FAILURE' — The type of error.
        - `Message` string — The error message.
      - `Status` 'CREATION_IN_PROGRESS' | 'CREATION_SUCCESSFUL' | 'CREATION_FAILED' | 'UPDATE_IN_PROGRESS' | 'UPDATE_SUCCESSFUL' | 'UPDATE_FAILED' | 'DELETED' — The status of the theme version.
    - `CreatedTime` string, date-time — The date and time that the theme was created.
    - `LastUpdatedTime` string, date-time — The date and time that the theme was last updated.
    - `Type` 'QUICKSIGHT' | 'CUSTOM' | 'ALL' — The type of theme, based on how it was created. Valid values include: <code>QUICKSIGHT</code> and <code>CUSTOM</code>.
  - `Status` integer — The HTTP status of the request.
  - `RequestId` string — The Amazon Web Services request ID for this operation.

## Other responses

- `480` — AccessDeniedException
- `481` — InvalidParameterValueException
- `482` — ResourceExistsException
- `483` — ResourceNotFoundException
- `484` — ThrottlingException
- `485` — UnsupportedUserEditionException
- `486` — InternalFailureException

---

[API](https://skmtc.net/aws/apis/quicksight.md) · [All operations](https://skmtc.net/aws/apis/quicksight/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/quicksight/versions/2f2bbd7e70ca/schema)