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

# List all subscribers

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

Returns a variety of information about one or more Subscribers

## Path parameters

- `domain` integer, required

## Query parameters

- `with` string
- `filter` object
  - `groups` integer[] — Array must contain existing group ids.
  - `search` string
  - `status` 'active' | 'all' | 'bounced' | 'junk' | 'unconfirmed' | 'under_verification' | 'unsubscribed' — Status of the resource `{name}`
  - `validation_status` 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` 78d6c681Subscriber[]
    - `id` integer, required — Unique identifier of the resource `Subscriber`
    - `email` string, required — Valid email address as per RFC 2821
    - `status` 'active' | 'bounced' | 'junk' | 'unconfirmed' | 'unsubscribed', nullable, required — Status of the resource `Subscriber`
    - `created_at` integer, required — Timestamp `Subscriber` has been created
    - `added_at` integer
    - `source` 'api' | 'import' | 'manual' | 'webform', nullable
    - `last_location` string, nullable
    - `statistics` object
      - `sent_count` integer, required — Number of emails sent
      - `open_count` integer, required — Number of emails opened
      - `click_count` integer, required — Number of emails clicked
      - `open_rate` number, required — value between 0-100
      - `click_rate` number, required — value between 0-100
    - `groups` 78d6c681Group[]
      - `id` integer, required — Unique identifier of the resource `Group`
      - `name` string, required — Name of the resource `Group`
      - `updated_at` integer, required — Timestamp `Group` has been updated
      - `subscribed_count` string
      - `statistics` object
        - `open_rate` number, required — value between 0-100
        - `click_rate` number, required — value between 0-100
      - `domain` string — Unique identifier of the `Domain` to request
    - `sources` 78d6c681Source[]
      - `id` integer, required — Unique identifier of the resource `Source`
      - `sourceable_type` string, required
      - `sourceable_id` integer, required
      - `type` integer, required
      - `ip` string, required
      - `created_at` integer, required — Timestamp `Source` has been created
    - `fields` 78d6c681Field[]
      - `id` integer, required — Unique identifier of the resource `Field`
      - `name` string, required — Name of the resource `Field`
      - `key` string, required
      - `value` string
  - `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/667aae28fec6/schema)