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

# List segments

`GET /v4/segments`

Returns a cursor-paginated list of all segments in the account with their `id`, `name`, and creation date.

Segments are created and managed in the Kit app — the API doesn't currently support creating or updating them. Use segment ids for targeting, for example in a broadcast's `subscriber_filter` (see [Create a broadcast](/api-reference/broadcasts/create-a-broadcast)).

## Query parameters

- `after` unknown
- `before` unknown
- `include_total_count` boolean
- `per_page` unknown

## Response `200`

Returns a paginated list of all segments for your account

- object
  - `segments` object[], required
    - `id` integer, required
    - `name` string, required
    - `created_at` string, required
  - `pagination` object, required
    - `has_previous_page` boolean, required
    - `has_next_page` boolean, required
    - `start_cursor` string, required
    - `end_cursor` string, required
    - `per_page` integer, required

## Other responses

- `401` — Returns a 401 if the token and/or account cannot be authenticated

---

[API](https://skmtc.net/kit/apis/kit-api.md) · [All operations](https://skmtc.net/kit/apis/kit-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kit/kit-api/revisions/0df0c90d12da/schema)