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

# Get subscriber growth

`GET /report/subscriber-status-change`

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

Entries contain net changes per status, including negative values; confirmed changes are not a count of new signup submissions. Larger intervals sum daily changes. 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)