---
title: "Retrieve all segments"
method: GET
path: "/brands/{brand_id}/segments"
tags: ["Segments"]
---

# Retrieve all segments

`GET /brands/{brand_id}/segments`

Supports pagination and exact-match filtering on segment fields.

## Path parameters

- `brand_id` integer, required

## Query parameters

- `limit` integer
- `offset` integer
- `page` integer
- `pageSize` integer

## Response `200`

Segments retrieved successfully.

- SegmentCollectionResponse
  - `data` Segment[], required
    - `segment_id` integer, nullable
    - `_brand_id` integer, nullable
    - `name` string, nullable
    - `description` string, nullable
    - `active` union
      - integer
      - boolean
  - `pagingData` PagingData
    - `prevPage` integer, nullable
    - `currentPage` integer, nullable
    - `nextPage` integer, nullable
    - `currentPageString` string, nullable
    - `hasMore` boolean

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/slicktext/apis/slicktext-api-new-platform.md) · [All operations](https://skmtc.net/slicktext/apis/slicktext-api-new-platform/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/slicktext/slicktext-api-new-platform/revisions/6f6c30f01b42/schema)