---
title: "List all segments"
method: GET
path: "/1/newsletters/{domain}/segments"
tags: ["Segments"]
---

# List all segments

`GET /1/newsletters/{domain}/segments`

Returns a variety of information about one or more Segment

## Path parameters

- `domain` integer, required

## Query parameters

- `with` string
- `filter` object
  - `search` string
  - `status` 'active' | 'inactive' — Status of the resource `{name}`
- `newsletter_id` integer
- `return` 'total'
- `limit` integer
- `skip` integer
- `page` integer
- `per_page` integer
- `order_by` union
  - string
  - string[]
- `order` 'asc' | 'desc'
- `order_for` object

## Response `200`

OK

- object
  - `result` 'success' | 'error' | 'asynchronous', required — Result of the HTTP request
  - `data` 78d6c681Segment[]
    - `id` integer, required — Unique identifier of the resource `Segment`
    - `name` string, required — Name of the resource `Segment`
    - `data` unknown[]
      - unknown
    - `subscribed_count` integer, required
    - `updated_at` integer, required — Timestamp `Segment` has been updated
    - `statistics` object
  - `total` integer — Total number of items Added when using query parameter `page`
  - `page` integer — Number of the current page Added when using query parameter `page`
  - `pages` integer — Total number of pages Added when using query parameter `page`
  - `items_per_page` integer — Number of items per page Added when using query parameter `page`

## Other responses

- `500` — Internal Server Error

---

[API](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools.md) · [All operations](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/infomaniak/api-reference-developer-tools/revisions/158a854b0c7d/schema)