---
title: "List Term Sets"
method: GET
path: "/brand-terms/term-sets"
tags: ["brandTerms"]
---

# List Term Sets

`GET /brand-terms/term-sets`

Get a pageable list of term sets with all their associated terms and domains.

The search filter searches the term set context and term text fields.

## Query parameters

- `page` integer
- `page_size` integer
- `search_term` string, nullable
- `domain_ids` string[], nullable
- `has_context` boolean, nullable

## Headers

- `Authorization` string, required

## Response `200`

Successful Response

- PaginatedTermSetsResponse — Pageable response for term sets in term management UI
  - `term_sets` TermSetWithTerms[], required
    - `id` string, uuid, required
    - `context` string, required
    - `term_type` 'preferred' | 'prohibited'
    - `context_polarity` 'include' | 'exclude'
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `created_by` string, nullable
    - `updated_by` string, nullable
    - `terms` TermDetail[], required
      - `id` string, uuid, required
      - `term` string, required
      - `type` 'preferred' | 'prohibited', required
      - `case_sensitive` boolean
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
      - `created_by` string, nullable
      - `updated_by` string, nullable
    - `domains` DomainSummary[]
      - `id` string, uuid, required
      - `name` string, required
  - `total_count` integer, required
  - `total_unfiltered_term_sets` integer, required
  - `page` integer, required
  - `page_size` integer, required
  - `total_pages` integer, required

## Other responses

- `401` — Authentication failed or no valid API key provided.
- `403` — Forbidden
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/markup/apis/api-reference.md) · [All operations](https://skmtc.net/markup/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/markup/api-reference/revisions/8e28e770c55d/schema)