Skip to navigation
API ReferenceLists

View recent activity

Get a member’s activity on a specific list, including opens, clicks, and unsubscribes.

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.
subscriber_hashstringRequired

The MD5 hash of the lowercase version of the list member's email address. This endpoint also accepts a list member's email address or contact_id.

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.

countintegerOptional<=1000Defaults to 10
The number of records to return. Default value is 10. Maximum value is 1000
offsetintegerOptionalDefaults to 0

Used for pagination, this is the number of records from a collection to skip. Default value is 0.

activity_filterslist of enumsOptional

A comma-separated list of activity filters that correspond to a set of activity types, e.g "?activity_filters=open,bounce,click".

Response

This endpoint returns an object.
activitylist of anyOptionalRead-only

An array of objects, each representing a contact event. There are multiple possible types, see the activity schema documentation.

email_idstringOptionalRead-only
The MD5 hash of the lowercase version of the list member's email address.
list_idstringOptionalRead-only
The list id.