---
title: "Retrieve a list of themes"
method: GET
path: "/api/v1/themes"
tags: ["Themes"]
---

# Retrieve a list of themes

`GET /api/v1/themes`

Required scope: `themes:read` </br>Organization authorization: `supported`

## Query parameters

- `page` integer
- `perPage` integer
- `operatorId` integer, nullable — Allows filtering themes by `operatorId`.</br>*Note:*The operatorId must be in the consumer’s operatorIds or, if empty, belong to the organization’s sub-operators.

## Response `200`

List of themes that match the criteria

- OffsetBasedResponse46
  - `data` ThemeDto[], required
    - `id` integer — Unique identifier of the theme
    - `name` string, required — Name of the theme
    - `title` string, required — Title of the theme formatted with operator name
    - `primaryColor` string, required — Primary color in HEX format
    - `secondaryColor` string, required — Secondary color in HEX format
    - `logoUrl` string, required — Url of the logo image
    - `favIconUrl` string, required — Url of the favicon image
    - `operator` ThemeOperatorDto, required
      - `id` integer — Operator id
      - `identifier` string, required — Operator identifier
      - `themingEnabled` boolean — Indicates if theming is enabled for the operator
  - `meta` MontaPageMeta, required
    - `itemCount` integer, required
    - `currentPage` integer, required
    - `perPage` integer, required
    - `totalPageCount` integer, required
    - `totalItemCount` integer, required

## Other responses

- `400` — The request is invalid
- `401` — Consumer with provided credentials was not found
- `403` — Operator doesn't have access to resource
- `404` — Entity with the provided id was not found

---

[API](https://skmtc.net/monta/apis/monta-partner-api.md) · [All operations](https://skmtc.net/monta/apis/monta-partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/monta/monta-partner-api/versions/517e18f11015/schema)