---
title: "Get account themes"
method: GET
path: "/v2/accounts/{account_id}/themes"
tags: ["Accounts"]
---

# Get account themes

`GET /v2/accounts/{account_id}/themes`

## Request

- Base URL: `https://api.getpaid.io`
- URL: `https://api.getpaid.io/v2/accounts/{account_id}/themes`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://auth.getpaid.io/oauth/token` scopes: `accounts:read`
- TypeScript: <https://skmtc.dev/getpaid/apis/getpaid-api/docs/v2/accounts/:account_id/themes/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve the themes configured for an account.

Sellers can retrieve themes they own. Platforms can retrieve themes for sellers they own.

## Path parameters

- `account_id` string, id, required: The unique identifier of the account.

## Response `200`

OK

- GetThemesResponse
  - `themes` AccountTheme[], required: The account themes.
    - `id` string, id, required: The unique identifier of the theme.
    - `name` string, required: The name of the theme.
    - `settings` AccountThemeSettings, required
      - `logo` ThemeAsset, required
        - `id` string, id, required: The unique identifier of the document.
        - `content_type` string, required: The media type of the theme asset.
        - `url` string, uri, required: The public URL of the theme asset.
      - `icon` ThemeAsset
        - `id` string, id, required: The unique identifier of the document.
        - `content_type` string, required: The media type of the theme asset.
        - `url` string, uri, required: The public URL of the theme asset.
      - `business` ThemeBusinessSettings, required
        - `legal_name` string, required: The legal business name displayed by the theme.
        - `trading_name` string: The trading name displayed by the theme.
      - `colors` ThemeColorSettings, required
        - `primary` string, required: The primary theme color as a hex RGB value.
        - `secondary` string, required: The secondary theme color as a hex RGB value.
        - `text` string: The text theme color as a hex RGB value.
        - `error_text` string: The error text theme color as a hex RGB value.
      - `font` ThemeFontSettings
        - `family` string: The font family used by the theme.
        - `size` string: The base font size used by the theme.
        - `external_url` string, uri: The URL of the external font stylesheet used by the theme.
    - `is_default` boolean, required: Whether this is the default theme for the account.
    - `created_at` string, date-time, required: UTC timestamp in ISO 8601 format with milliseconds ([RFC 3339](https://www.rfc-editor.org/rfc/rfc3339.html)). Always includes the 'Z' UTC indicator.
    - `updated_at` string, date-time, required: UTC timestamp in ISO 8601 format with milliseconds ([RFC 3339](https://www.rfc-editor.org/rfc/rfc3339.html)). Always includes the 'Z' UTC indicator.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/getpaid/apis/getpaid-api.md) - [All operations](https://skmtc.dev/getpaid/apis/getpaid-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getpaid/apis/getpaid-api/revisions/776466b63d14?raw)