---
title: "Get Segment"
method: GET
path: "/segments/{segmentId}"
tags: ["Segments"]
---

# Get Segment

`GET /segments/{segmentId}`

Get detailed information about a specific segment, including its filter configuration, description, and metadata. Accepts either a UUID or a preset ID for system segments.

## Path parameters

- `segmentId` string, required — The segment ID (UUID) or preset ID for system segments.

## Response `200`

Segment retrieved successfully

- GetSegmentResponse
  - `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.
  - `description` string, nullable, required — A description of the segment.
  - `icon` string, nullable, required — Icon identifier for the segment.
  - `filters` object, required — The filter/rule configuration for the segment.
  - `createdBy` string, uuid, nullable, required — The user ID who created this segment.
  - `createdAt` string, date-time, required — When the segment was created.
  - `updatedAt` string, date-time, required — When the segment was last updated.

## Other responses

- `404` — Segment not found
- `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/:segmentId/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)