---
title: "Get subscriber totals"
method: GET
path: "/report/subscriber-status-total"
tags: ["Subscriber reports"]
---

# Get subscriber totals

`GET /report/subscriber-status-total`

## 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/report/subscriber-status-total`
- Auth: API key in header `X-API-Key`

Daily entries contain the subscriber count for each status. Larger intervals contain average counts. Reports cover the authenticated account across all websites and sources. Dates are inclusive and normalized to the available account period. logDateTime is a display label localized using the account locale.

## Query parameters

- `fromDate` string, required
- `interval` string
- `toDate` string, required

## Response `200`

Subscriber report

- SubscriberStatusChangeReportDto
  - `reportPeriod` ReportPeriodDto
    - `fromDate` string
    - `toDate` string
    - `interval` 'DAY' | 'WEEK' | 'MONTH' | 'QUARTER' | 'YEAR'
  - `entries` SubscriberStatusChangeSnapshotDto[]
    - `pending` integer
    - `confirmed` integer
    - `unsubscribed` integer
    - `bounced` integer
    - `blocked` integer
    - `deleted` integer
    - `logDateTime` string

## Other responses

- `401`: Missing or invalid API key
- `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)