# include_total_contacts on GET /3.0/lists/{} is deprecated

Mailchimp Marketing API deprecated GET /3.0/lists/{id}, query parameter include_total_contacts without giving a shutdown date yet.

## What to use instead

Read the audience contact count from the /audiences endpoints.

The /audiences endpoints are in beta.

- API: Mailchimp Marketing API (*.api.mailchimp.com)
- Kind: Parameter removal
- Takes effect: no date given yet
- Calls after that day: fail
- Calls it hits: `GET /3.0/lists/{id}`, `query parameter include_total_contacts`
- Source: [Announcement](https://mailchimp.com/developer/marketing/api/lists/get-list-info/)
- Verified: November 6, 2026, against Mailchimp Marketing API's own pages
- Page: https://www.okapi.bot/providers/mailchimp-marketing-api/breaking-changes/include-total-contacts-on-get-3-0-lists-is-deprecated-2/

## Mailchimp Marketing API's words

> Deprecated. Return the total_contacts field in the stats response, which contains an approximate count of subscribed, unsubscribed, and transactional contacts. For a complete audience contact count, use the /audiences endpoint instead.

Okapi finds the calls this change hits in your repo and opens the pull request with the fix: https://github.com/apps/okapi-agent