---
title: "Get subscribers"
method: GET
path: "/lists/{list_id}/subscribers"
tags: ["Lists"]
---

# Get subscribers

`GET /lists/{list_id}/subscribers`

Retrieve a paginated list of subscribers from a specific list.

## Path parameters

- `list_id` integer, required

## Query parameters

- `page` integer
- `status` string
- `per_page` integer

## Response `200`

OK

- object
  - `current_page` integer
  - `data` object[]
    - `list_id` integer
    - `email` string
    - `status` integer
    - `subscribed_at` string
    - `unsubscribed_at` unknown
    - `custom_fields` unknown[]
      - unknown
    - `groups` unknown
    - `source` string
    - `subscriber` object
      - `id` integer
      - `name` string
      - `surname` string
      - `email` string
      - `gender` string
      - `company` unknown
      - `city` string
      - `country` string
      - `phone` unknown
  - `per_page` integer
  - `total` integer

---

[API](https://skmtc.dev/ecomail/apis/ecomail-api.md) · [All operations](https://skmtc.dev/ecomail/apis/ecomail-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ecomail/ecomail-api/revisions/31b5789931fe/schema)