---
title: "Get Segment List Subscribers"
method: GET
path: "/accounts/segment-lists/{listId}/subscribers"
tags: ["Segment List"]
---

# Get Segment List Subscribers

`GET /accounts/segment-lists/{listId}/subscribers`

Retrieves a paginated list of subscribers associated with a specific  segment list. The response contains subscriber profiles including contact  details, geographic regions, and profile image URLs.

## Path parameters

- `listId` string, required

## Query parameters

- `search` string
- `pageNumber` integer, required
- `pageSize` integer, required

## Response `200`

Success

- ListSubscribersPaginatedResponse3ExternalApiResponseNew
  - `data` ListSubscribersPaginatedResponse3
    - `pageNumber` integer
    - `pageSize` integer
    - `totalCount` integer
    - `totalPages` integer
    - `data` ListSubscribers[], nullable
      - `firstName` string, nullable — The subscriber's first name.
      - `lastName` string, nullable — The subscriber's last name.
      - `subscriberNo` string — The mobile phone number of the subscriber.
      - `region` string — The geographic territory or region assigned to the subscriber profile.
      - `email` string, nullable — The subscriber's email address.
      - `imageUrl` string, nullable — A direct URL hosting the subscriber's avatar or profile picture.
      - `createdAt` string, date-time
  - `appCode` string, nullable
  - `message` string, nullable
  - `isError` boolean

## Other responses

- `400` — Bad Request

---

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