---
title: "Count subscribers"
method: GET
path: "/subscribers/count"
tags: ["Subscribers"]
---

# Count subscribers

`GET /subscribers/count`

## 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/count`
- Auth: API key in header `X-API-Key`

Returns the number of subscribers for a given status.

## Query parameters

- `status` string

## Response `200`

Count returned.

- Number: Holds a numeric value along with a formatted representation. This record is used to encapsulate a number and its corresponding formatted string.
  - `value` integer: The numeric value.
  - `formattedValue` string: A formatted string representation of the numeric value. This might include locale-specific formatting like commas or currency symbols.

## Other responses

- `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)