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

# List all segments

`GET /segments`

You can fetch a list of all segments.

## Query parameters

- `include_count` boolean

## Headers

- `Intercom-Version` '1.0' | '1.1' | '1.2' | '1.3' | '1.4' | '2.0' | '2.1' | '2.2' | '2.3' | '2.4' | '2.5' | '2.6' | '2.7' | '2.8' | '2.9' | '2.10' | '2.11' | '2.12' | '2.13' | '2.14' — Intercom API version.</br>By default, it's equal to the version set in the app package.

## Response `200`

Successful response

- SegmentList — This will return a list of Segment Objects. The result may also have a pages object if the response is paginated.
  - `type` 'segment.list' — The type of the object
  - `segments` Segment[] — A list of Segment objects
    - `type` 'segment' — The type of object.
    - `id` string — The unique identifier representing the segment.
    - `name` string — The name of the segment.
    - `created_at` integer — The time the segment was created.
    - `updated_at` integer — The time the segment was updated.
    - `person_type` 'contact' | 'user' — Type of the contact: contact (lead) or user.
    - `count` integer, nullable — The number of items in the user segment. It's returned when `include_count=true` is included in the request.
  - `pages` object — A pagination object, which may be empty, indicating no further pages to fetch.

## Other responses

- `401` — Unauthorized

---

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