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

# List segments

`GET /v1/segments`

Retrieve a list of all of your segments.

## Response `200`

Returns an array of `segments`. Each object in the response represents an individual segment.

- object
  - `segments` SegmentResponseObject[]
    - `id` integer — The identifier for a segment; used to target a segment in requests.
    - `deduplicate_id` string — An identifier in the format `id:timestamp` where the id is for the object you're working with (Automations, Deliveries, Exports, Identities, Newsletters, Segments, and Templates), and the timestamp is the last time the object was updated.
    - `name` string — The name of the segment.
    - `description` string — A description for the segment. This can help you understand the purpose of the segment when you encounter it in other requests or in the UI.
    - `state` 'events' | 'build' | 'events_queued' | 'build_queued' | 'finished' — The segment build state: - `events`—handling event conditions for this segment - `build`—handling profile attribute conditions for this segment - `events_queued`—waiting to start handling event conditions - `build_queued`—waiting to start handling profile attribute conditions - `finished`—the segment is finished building
    - `progress` integer, nullable — If Customer.io has not finished processing the segment, this indicates the percentage complete. Otherwise, this key is null.
    - `type` 'dynamic' | 'manual' — The type of segment.
    - `tags` string[], nullable — The tags assigned to the segment, if any. Tags may help you sort through your segments.
    - `created_at` integer — The date time when the referenced ID was created.
    - `updated_at` integer — The date time when the referenced ID was last updated.

## Other responses

- `429` — Your request is over the 10-per-second limit.

---

[API](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference.md) · [All operations](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/customer/customer-io-journeys-api-reference/revisions/4b391af7cb06/schema)