Skip to navigation
API ReferenceLists

List locations

Get the locations (countries) that the list’s subscribers have been tagged to based on geocoding their IP address.

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.

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.
list_idstringOptional
The unique id for the list.
locationslist of objectsOptional
An array of objects, each representing a list's top subscriber locations.
total_itemsintegerOptionalRead-only
The total number of items matching the query regardless of pagination.