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

# GET all Segments

`GET /segments`

Use this method to get a list of all segments associated with the account. You can sort segment results and limit the number of segments that display per page. Deleted segments are excluded from the results. For more use case information, see [Get All Segments](/api_guide/segment_get_all.html) in the API guide.

## Query parameters

- `limit` string
- `sort_by` string

## Response `200`

Request successful.

- SegmentsDTO
  - `segments` SegmentMaster[], required — Lists all segments for the account.
    - `name` string — The segment's unique descriptive name.
    - `segment_id` integer — The system generated number that uniquely identifies the segment.
    - `created_at` string, date-time — The system generated date and time that the segment was created (ISO-8601 format).
    - `edited_at` string, date-time — The system generated date and time that the segment's <code>name</code> or <code>segment_criteria</code> was last updated (ISO-8601 format).
  - `_links` SegmentsLinks
    - `next` Next, required
      - `href` string, required — The next link in the page, or null if there are no additional pages.

## Other responses

- `400` — Bad request. Either the JSON was malformed or there was a data validation error.
- `401` — The Access Token used is invalid.
- `403` — Forbidden request. You lack the necessary scopes, you lack the necessary user privileges, or the application is deactivated.
- `404` — The requested resource was not found.
- `415` — Unsupported Media Type.
- `429` — Too many requests. You exceeded the request rate limit.
- `500` — There was a problem with our internal service.

---

[API](https://skmtc.net/cc/apis/appconnect-v3.md) · [All operations](https://skmtc.net/cc/apis/appconnect-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cc/appconnect-v3/revisions/4b4a534c818d/schema)