> ## Documentation Index
> Fetch the complete documentation index at: https://developer.z-api.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List channel subscribers

> Returns the complete list of channel subscribers

## Overview

This method returns the complete list of channel subscribers.

***

## Attributes

### Header

<ParamField path="instanceId" type="string" required>
  Your instance ID. Available in the Z-API panel under **Instances**.
</ParamField>

<ParamField path="token" type="string" required>
  Your Z-API instance token.
</ParamField>

### Path

<ParamField path="newsletterId" type="string" required>
  Channel ID
</ParamField>

***

## Response

### 200

Returns an array of subscriber objects.

<ResponseField name="id" type="string">
  Subscriber ID (can be a phone number or a `@lid`)
</ResponseField>

<ResponseField name="phoneNumber" type="string">
  Subscriber's phone number, when available
</ResponseField>

<ResponseField name="displayName" type="string">
  Subscriber's display name, when available
</ResponseField>

<ResponseField name="username" type="string">
  Subscriber's username, when available
</ResponseField>

<ResponseField name="role" type="string">
  Subscriber's role in the channel (OWNER, ADMIN or SUBSCRIBER)
</ResponseField>

<ResponseField name="followTime" type="number">
  Timestamp of when the user started following the channel, when available
</ResponseField>

<ResponseField name="adminProfile" type="object">
  Subscriber's admin profile information, when they are an admin of the channel

  <Expandable title="Properties">
    <ResponseField name="id" type="string">
      Admin ID
    </ResponseField>

    <ResponseField name="name" type="string">
      Admin name
    </ResponseField>

    <ResponseField name="pictureDirectPath" type="string">
      Admin's profile picture path, when available
    </ResponseField>
  </Expandable>
</ResponseField>

```json theme={"theme":{"light":"github-light","dark":"poimandres"}}
[
  {
    "id": "199690293383294@lid",
    "phoneNumber": null,
    "displayName": null,
    "username": null,
    "role": "SUBSCRIBER",
    "followTime": null,
    "adminProfile": null
  },
  {
    "id": "277454937673921@lid",
    "phoneNumber": null,
    "displayName": null,
    "username": null,
    "role": "SUBSCRIBER",
    "followTime": null,
    "adminProfile": null
  }
]
```

<Info>
  The channel ID must always contain the **@newsletter** suffix, as this is the standard used by WhatsApp.
</Info>

<Info>
  WhatsApp only returns subscribers who are in the requester's contact list, and the requester must be an admin of the channel. This list has no pagination, returning all available subscribers in a single response.
</Info>

### 405

Make sure you are correctly sending the method specification, that is, verify that you sent POST or GET as specified at the beginning of this topic.

### 415

If you receive a 415 error, make sure to add the "Content-Type" header to your request, which in most cases is "application/json".