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

# List segments

`GET /segments`

Get all audience segments for the project, newest first. This endpoint is not paginated — it returns a bare array of every segment.

## Response `200`

List of segments

- Segment[]
  - `id` string
  - `name` string
  - `description` string, nullable
  - `type` 'DYNAMIC' | 'STATIC' — `DYNAMIC` segments are evaluated from `condition`. `STATIC` segments hold a manually managed member list.
  - `condition` FilterCondition — A boolean tree over contact filters. `logic` combines the `groups`; the filters inside each group are always ANDed together.
    - `logic` 'AND' | 'OR', required
    - `groups` FilterGroup[], required
      - `filters` Filter[], required — Filters within a group are combined with AND.
        - `field` string, required — Contact field to test. Custom fields are addressed via the `data.` prefix (e.g. `data.plan`); standard fields are `email`, `subscribed`, `createdAt`. Event operators take an event name instead.
        - `operator` 'equals' | 'notEquals' | 'contains' | 'notContains' | 'greaterThan' | 'lessThan' | 'greaterThanOrEqual' | 'lessThanOrEqual' | 'exists' | 'notExists' | 'within' | 'olderThan' | 'triggered' | 'triggeredWithin' | 'triggeredOlderThan' | 'notTriggered' | 'notTriggeredWithin' | 'memberOfSegment' | 'notMemberOfSegment', required
        - `value` unknown
        - `unit` 'days' | 'hours' | 'minutes' — Time unit for window operators (`within`, `olderThan`, `triggeredWithin`, `triggeredOlderThan`, `notTriggeredWithin`).
      - `conditions` FilterCondition — recursive
  - `trackMembership` boolean — When true, contacts entering or leaving the segment emit `segment.<slug>.entry` / `segment.<slug>.exit` events.
  - `memberCount` integer — Cached member count, refreshed by a background job rather than computed per request.
  - `projectId` string
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

## Other responses

- `401` — Missing or invalid API key.

---

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