---
title: "Get All Segment Lists"
method: GET
path: "/accounts/segment-lists"
tags: ["Segment List"]
---

# Get All Segment Lists

`GET /accounts/segment-lists`

Retrieves a paginated list of all subscriber segment lists created across the account.  Supports global search filtering by list name to quickly locate specific subscriber segments.

## Query parameters

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

## Response `200`

Success

- ListsPaginatedResponse3ExternalApiResponseNew
  - `data` ListsPaginatedResponse3
    - `pageNumber` integer
    - `pageSize` integer
    - `totalCount` integer
    - `totalPages` integer
    - `data` Lists[], nullable
      - `listId` string
      - `name` string
      - `totalSubscribers` integer
      - `status` string, nullable
      - `description` string, nullable
      - `processedFileUrl` string, nullable
  - `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)