---
title: "List terminal themes"
method: GET
path: "/companies/{companyId}/terminalThemes"
tags: ["Terminal themes - company level"]
---

# List terminal themes

`GET /companies/{companyId}/terminalThemes`

## Request

- Base URL: `https://management-test.adyen.com/v3`
- URL: `https://management-test.adyen.com/v3/companies/{companyId}/terminalThemes`
- Auth: one of:
  - HTTP basic
  - API key in header `X-API-Key`

Returns a paginated list of terminal themes for the company specified in the path and all the associated merchant accounts. The response provides only the metadata of the themes. Assets (images and videos) are not included. To obtain the URLs for the assets of a specific theme, make a GET request to the `/companies/{companyId}/terminalThemes/{id}` endpoint.

To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#manage-api-permissions): 
- Management API - Terminal themes read and write

## Path parameters

- `companyId` string, required

## Query parameters

- `pageSize` integer
- `page` integer
- `search` string

## Response `200`

OK

- ListThemesResponse: The response with the paginated list of terminal themes containing the metadata of the themes.
  - `data` ThemeSummary[], required: The list of themes for the requested page.
    - `id` string, required: The unique identifier of the theme.
    - `mode` 'dark' | 'light', required: The terminal display mode. Possible values: **dark**, **light**.
    - `name` string, required: The name of the theme.
  - `hasNextPage` boolean, required: Indicates whether there are more themes after the current page.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Entity
- `500`: Internal Server Error

## Changes

- **2026-09-23** (v3) `55cb8143ce0e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/adyen/apis/management-api/changes/companies/:companyId/terminalThemes/get.md)

---

[API](https://skmtc.dev/adyen/apis/management-api.md) - [All operations](https://skmtc.dev/adyen/apis/management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/adyen/apis/management-api/revisions/55cb8143ce0e?raw)