Skip to navigation
API ReferenceLists

Get growth history by month

Get a summary of a specific list’s growth activity for a specific month and year.

Authentication

AuthorizationBearer

Authorization using a Mailchimp API key (a.k.a. Bearer token)

OR
AuthorizationBearer
Authorization using OAuth

Path parameters

list_idstringRequired
The unique ID for the list.
monthstringRequired
A specific month of list growth history.

Query parameters

fieldslist of stringsOptional

A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.

exclude_fieldslist of stringsOptional

A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Response

This endpoint returns an object.
cleanedintegerOptionalRead-only

Newly cleaned (hard-bounced) members on the list for a specific month.

deletedintegerOptionalRead-only
Newly deleted members on the list for a specific month.
existingintegerOptionalRead-only

(deprecated)

importsintegerOptionalRead-only

(deprecated)

list_idstringOptionalRead-only
The list id for the growth activity report.
monthstringOptionalRead-only
The month that the growth history is describing.
optinsintegerOptionalRead-only

(deprecated)

pendingintegerOptionalRead-only
Pending members on the list for a specific month.
reconfirmintegerOptionalRead-only
Newly reconfirmed members on the list for a specific month.
subscribedintegerOptionalRead-only
Total subscribed members on the list at the end of the month.
transactionalintegerOptionalRead-only
Subscribers that have been sent transactional emails via Mandrill.
unsubscribedintegerOptionalRead-only
Newly unsubscribed members on the list for a specific month.