---
title: "List Segments"
method: GET
path: "/segments"
tags: ["Segments"]
---

# List Segments

`GET /segments`

List all segments in your workspace. Returns summary data including member counts. Supports pagination.

## Query parameters

- `page` number — Page number (default: 1).
- `pageSize` number — Number of results per page (default: 50, max: 100).

## Response `200`

Segments retrieved successfully

- SegmentSummary[] — Array of segments.
  - `id` string, uuid, required — The segment ID.
  - `name` string, required — The segment name.
  - `type` 'system' | 'custom', required — Whether the segment is system-defined or custom.
  - `presetId` string, nullable, required — Preset identifier for system segments.
  - `memberCount` number, required — Number of participants in this segment.
  - `isFavorited` boolean, required — Whether the segment is favorited.

## Other responses

- `400` — Bad request - invalid parameters
- `500` — Server error

## Changes

- **2026-05-01** `f52e699d4abf` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/greenflash-ai/apis/greenflash-api-reference/changes/segments/get.md)

---

[API](https://skmtc.dev/greenflash-ai/apis/greenflash-api-reference.md) · [All operations](https://skmtc.dev/greenflash-ai/apis/greenflash-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/greenflash-ai/greenflash-api-reference/revisions/c566e560677d/schema)