---
title: "Retrieve paginated subscribers"
method: GET
path: "/subscribers"
tags: ["Subscribers"]
---

# Retrieve paginated subscribers

`GET /subscribers`

## Request

- Base URL: `https://api.maildroppa.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.maildroppa.com/subscribers`
- Auth: API key in header `X-API-Key`

Returns a list of subscribers filtered by status and query, with pagination.

## Query parameters

- `pageNumber` integer
- `pageSize` integer
- `query` string
- `status` string

## Response `200`

Successful retrieval.

- PaginatedSubscribersDto: Paginated response containing SubscriberDto items.
  - `items` SubscriberOverview[]: The items on the current page.
    - `id` string, uuid
    - `email` string: Subscriber email address.
    - `firstName` string: Subscriber first name, if present.
    - `subscriberStatus` 'PENDING' | 'CONFIRMED' | 'UNSUBSCRIBED' | 'COLD' | 'BOUNCED' | 'SOFT_BOUNCED' | 'BLOCKED' | 'DELETED'
    - `registeredAt` string: Registration date/time of the subscriber.
    - `lastImportedAtUtc` string, date-time
    - `tags` string[]: List of tag identifiers associated with the subscriber.
    - `visibleFieldValues` SubscriberFieldValue[]: Visible subscriber field display values for the list view.
      - `id` string, uuid
      - `personalizationTagName` string: Stable subscriber personalization tag name returned in the personalizationTagName property.
      - `value` string: Display value for this field. Choice and multi-select values are returned as labels for display; use subscriber field value endpoints for typed option IDs.
  - `pageNumber` integer: Which page is this (1-based index)?
  - `pageSize` integer: Number of items per page.
  - `totalItems` integer: Total number of items matching the query.
  - `totalPages` integer: Total number of pages based on page size.
  - `statusCounts` SubscriberStatusCountsDto: Account-wide counts, independent of search, status filter and pagination. All includes every subscriber status.
    - `all` integer
    - `confirmed` integer
    - `pending` integer
    - `unsubscribed` integer

## Other responses

- `400`: Invalid request parameters.
- `401`: Not Authorized
- `403`: Not Allowed
- `428`: Accept the customer agreements in the app before using API keys.

---

[API](https://skmtc.dev/maildroppa/apis/maildroppa-api-beta.md) · [All operations](https://skmtc.dev/maildroppa/apis/maildroppa-api-beta/llms.txt) · [OpenAPI document](https://skmtc.dev/maildroppa/apis/maildroppa-api-beta/revisions/a9f5a3fd1fb0?raw)