Mailchimp

Mailchimp Reports API

The Reports API from Mailchimp — 24 operation(s) for reports.

GitHub OpenAPI
Business capability
Marketing Operations Management BC-400.50

Operations 44

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /reports List reports for sent campaigns · List campaign reports #
Ask an LLM
“Where can I see performance reports for all my sent campaigns?”
“Can I pull campaign reports only for campaigns sent in the last month?”
Tell an agent
List my campaign reports.
List reports for campaigns sent since {since_send_time}.
GET /reports/{campaign_id} Get the performance report for one campaign · Get campaign report #
Ask an LLM
“What were the open and click rates for a specific campaign I sent?”
“How did one particular campaign perform overall?”
Tell an agent
Get the report for campaign {campaign_id}.
Summarize the overall results of sent campaign {campaign_id}.
GET /reports/{campaign_id}/abuse-reports List spam complaints for a campaign · List abuse reports #
Ask an LLM
“Did anyone mark my campaign as spam?”
“How many abuse complaints did a campaign receive?”
Tell an agent
List the abuse complaints for campaign {campaign_id}.
Show who reported campaign {campaign_id} as spam.
GET /reports/{campaign_id}/abuse-reports/{report_id} Get one abuse complaint on a campaign · Get abuse report #
Ask an LLM
“Can I see the details of a single spam complaint on a campaign?”
“When was a specific abuse report filed and by which member?”
Tell an agent
Get abuse report {report_id} for campaign {campaign_id}.
Show the details of spam complaint {report_id} on campaign {campaign_id}.
GET /reports/{campaign_id}/advice Get improvement advice from a campaign's stats · List campaign feedback #
Ask an LLM
“What advice does Mailchimp give based on how my campaign performed?”
“Are there suggestions for improving a campaign given its opens, clicks and bounces?”
Tell an agent
Get the performance advice for campaign {campaign_id}.
Show stats-based recommendations for campaign {campaign_id}.
GET /reports/{campaign_id}/click-details List link click stats for a campaign · List campaign details #
Ask an LLM
“Which links in my campaign got the most clicks?”
“Can I exclude bot clicks when looking at link performance?”
Tell an agent
List click counts for every link in campaign {campaign_id}.
Show link clicks for campaign {campaign_id} with bot filtering set to {filter_bots}.
GET /reports/{campaign_id}/click-details/{link_id} Get click stats for one link in a campaign · Get campaign link details #
Ask an LLM
“How many people clicked one particular link in my email?”
“What's the click total for a single tracked URL in a campaign?”
Tell an agent
Get click details for link {link_id} in campaign {campaign_id}.
Show human-only clicks on link {link_id} of campaign {campaign_id}.
GET /reports/{campaign_id}/click-details/{link_id}/members List subscribers who clicked a campaign link · List clicked link subscribers #
Ask an LLM
“Who exactly clicked a specific link in my campaign?”
“Can I get the list of members who clicked one link so I can follow up?”
Tell an agent
List the subscribers who clicked link {link_id} in campaign {campaign_id}.
Show the first {count} members who clicked link {link_id} in campaign {campaign_id}.
GET /reports/{campaign_id}/click-details/{link_id}/members/{subscriber_hash} Get one subscriber's clicks on a campaign link · Get clicked link subscriber #
Ask an LLM
“Did a particular subscriber click a specific link in my campaign?”
“How many times did one member click a given link?”
Tell an agent
Get the clicks by subscriber {subscriber_hash} on link {link_id} in campaign {campaign_id}.
Check whether member {subscriber_hash} clicked link {link_id} of campaign {campaign_id}.
GET /reports/{campaign_id}/open-details List members who opened a campaign · List campaign open details #
Ask an LLM
“Who opened my campaign, and when?”
“Can I leave out Apple privacy proxy opens so I only see real human opens?”
Tell an agent
List who opened campaign {campaign_id}.
List opens of campaign {campaign_id} that happened since {since}.
GET /reports/{campaign_id}/open-details/{subscriber_hash} Get one subscriber's opens of a campaign · Get opened campaign subscriber #
Ask an LLM
“Did a specific subscriber open my campaign?”
“How many times did one member open a given email?”
Tell an agent
Get the open details for subscriber {subscriber_hash} in campaign {campaign_id}.
Check if member {subscriber_hash} opened campaign {campaign_id}.
GET /reports/{campaign_id}/domain-performance Compare campaign results by email domain · List domain performance stats #
Ask an LLM
“How did my campaign perform at Gmail versus other email domains?”
“Which recipient email domains had the best results for a campaign?”
Tell an agent
Show domain performance stats for campaign {campaign_id}.
Break down campaign {campaign_id} results by recipient email domain.
GET /reports/{campaign_id}/eepurl Get social sharing activity for a campaign · List EepURL activity #
Ask an LLM
“How much social activity did my campaign's EepURL generate?”
“Were there clicks or referrers from people sharing my campaign link?”
Tell an agent
Get the EepURL social activity for campaign {campaign_id}.
Show sharing and referrer stats for campaign {campaign_id}'s short link.
GET /reports/{campaign_id}/email-activity List every recipient's activity in a campaign · List email activity #
Ask an LLM
“Can I get a per-subscriber log of opens, clicks and bounces for a campaign?”
“What email activity happened in a campaign since yesterday?”
Tell an agent
List all recipient activity for campaign {campaign_id}.
List member activity in campaign {campaign_id} since {since}, excluding bots.
GET /reports/{campaign_id}/email-activity/{subscriber_hash} Get one member's full activity in a campaign · Get subscriber email activity #
Ask an LLM
“What did one specific subscriber do with my campaign — open, click or bounce?”
“Can I see the full activity timeline for a single recipient of a campaign?”
Tell an agent
Get the email activity of subscriber {subscriber_hash} in campaign {campaign_id}.
Show every open, click and bounce for member {subscriber_hash} on campaign {campaign_id}.
GET /reports/{campaign_id}/locations See where a campaign was opened geographically · List top open activities #
Ask an LLM
“Which countries opened my campaign the most?”
“Where in the world are people reading my email?”
Tell an agent
List the top open locations for campaign {campaign_id}.
Show the geographic breakdown of opens for campaign {campaign_id}.
GET /reports/{campaign_id}/sent-to List everyone a campaign was sent to · List campaign recipients #
Ask an LLM
“Who received my campaign?”
“Can I page through the full recipient list of a sent campaign?”
Tell an agent
List the recipients of campaign {campaign_id}.
Show {count} recipients of campaign {campaign_id} starting at offset {offset}.
GET /reports/{campaign_id}/sent-to/{subscriber_hash} Get delivery info for one campaign recipient · Get campaign recipient info #
Ask an LLM
“Was my campaign actually delivered to a particular subscriber?”
“What's the send status for one recipient of a campaign?”
Tell an agent
Get recipient info for {subscriber_hash} in campaign {campaign_id}.
Check delivery status of campaign {campaign_id} for recipient {subscriber_hash}.
GET /reports/{campaign_id}/sub-reports List child campaign reports for a parent campaign · List child campaign reports #
Ask an LLM
“How do I see reports for the child campaigns of an RSS or multivariate parent?”
“Can I get the sub-reports under a parent campaign?”
Tell an agent
List the child campaign reports for parent campaign {campaign_id}.
Show sub-reports belonging to campaign {campaign_id}.
GET /reports/{campaign_id}/unsubscribed List members who unsubscribed from a campaign · List unsubscribed members #
Ask an LLM
“Who unsubscribed after receiving my campaign?”
“How many people opted out because of a specific email?”
Tell an agent
List the members who unsubscribed from campaign {campaign_id}.
Show opt-outs caused by campaign {campaign_id}.
GET /reports/{campaign_id}/unsubscribed/{subscriber_hash} Get one member's unsubscribe from a campaign · Get unsubscribed member #
Ask an LLM
“Did a specific subscriber unsubscribe from my campaign, and why?”
“When did one member opt out through a particular campaign?”
Tell an agent
Get unsubscribe details for member {subscriber_hash} from campaign {campaign_id}.
Show the reason member {subscriber_hash} left via campaign {campaign_id}.
GET /reports/{campaign_id}/ecommerce-product-activity See product sales driven by a campaign · List campaign product activity #
Ask an LLM
“Which products did people buy after clicking my campaign?”
“How much ecommerce revenue per product came from a campaign?”
Tell an agent
List product activity for campaign {campaign_id}.
Show product purchases from campaign {campaign_id} sorted by {sort_field}.
GET /3.0/reports List campaign reports #
GET /3.0/reports/{campaign_id} Get campaign report #
GET /3.0/reports/{campaign_id}/abuse-reports List abuse reports #
GET /3.0/reports/{campaign_id}/abuse-reports/{report_id} Get abuse report #
GET /3.0/reports/{campaign_id}/advice List campaign feedback #
GET /3.0/reports/{campaign_id}/click-details List campaign details #
GET /3.0/reports/{campaign_id}/click-details/{link_id} Get campaign link details #
GET /3.0/reports/{campaign_id}/click-details/{link_id}/members List clicked link subscribers #
GET /3.0/reports/{campaign_id}/click-details/{link_id}/members/{subscriber_hash} Get clicked link subscriber #
GET /3.0/reports/{campaign_id}/domain-performance List domain performance stats #
GET /3.0/reports/{campaign_id}/ecommerce-product-activity List campaign product activity #
GET /3.0/reports/{campaign_id}/eepurl List EepURL activity #
GET /3.0/reports/{campaign_id}/email-activity List email activity #
GET /3.0/reports/{campaign_id}/email-activity/{subscriber_hash} Get subscriber email activity #
GET /3.0/reports/{campaign_id}/locations List top open activities #
GET /3.0/reports/{campaign_id}/open-details List campaign open details #
GET /3.0/reports/{campaign_id}/open-details/{subscriber_hash} Get opened campaign subscriber #
GET /3.0/reports/{campaign_id}/sent-to List campaign recipients #
GET /3.0/reports/{campaign_id}/sent-to/{subscriber_hash} Get campaign recipient info #
GET /3.0/reports/{campaign_id}/sub-reports List child campaign reports #
GET /3.0/reports/{campaign_id}/unsubscribed List unsubscribed members #
GET /3.0/reports/{campaign_id}/unsubscribed/{subscriber_hash} Get unsubscribed member #

Documentation

📖
Documentation
https://mailchimp.com/developer/marketing/docs/fundamentals/
📖
APIReference
https://mailchimp.com/developer/marketing/api/
📖
GettingStarted
https://mailchimp.com/developer/marketing/guides/quick-start/
📖
Authentication
https://mailchimp.com/developer/marketing/guides/access-user-data-oauth-2/
📖
Documentation
https://mailchimp.com/developer/transactional/docs/fundamentals/
📖
GettingStarted
https://mailchimp.com/developer/transactional/guides/quick-start/
📖
Authentication
https://mailchimp.com/developer/transactional/docs/authentication-delivery/
📖
APIReference
https://mailchimp.com/developer/transactional/api/
📖
GettingStarted
https://mailchimp.com/developer/transactional/guides/send-first-email/

Specifications

⚙
OpenAPI
https://artifacts.apis.io/mailchimp/openapi/mailchimp-reports-api-openapi.yml
⚙
AsyncAPI
https://artifacts.apis.io/mailchimp/asyncapi/mailchimp-marketing-webhooks-asyncapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/mailchimp/json-schema/campaign.json
📊
JSONSchema
https://artifacts.apis.io/mailchimp/json-schema/audience.json
📊
JSONSchema
https://artifacts.apis.io/mailchimp/json-schema/member.json
📊
JSONSchema
https://artifacts.apis.io/mailchimp/json-schema/template.json

Other Resources

🔗
JSONLD
https://artifacts.apis.io/mailchimp/json-ld/context.jsonld
🔗
Integrations
https://mailchimp.com/developer/marketing/docs/integrations/
🔗
ErrorCodes
https://mailchimp.com/developer/marketing/docs/errors/
🔗
E-Commerce
https://mailchimp.com/developer/marketing/docs/e-commerce/
🔗
Methods and Parameters
https://mailchimp.com/developer/marketing/docs/methods-parameters/
🔗
Webhooks
https://mailchimp.com/developer/transactional/docs/webhooks/
🔗
Outbound Email
https://mailchimp.com/developer/transactional/docs/outbound-email/
🔗
Tags and Metadata
https://mailchimp.com/developer/transactional/docs/tags-metadata/

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/mailchimp:mailchimp-reports-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

mailchimp-reports-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Mailchimp Reports API
  contact:
    name: Mailchimp API Support
    email: apihelp@mailchimp.com
  x-refined-note:
  - x-permalink differs across the merged source definitions and was not carried
  version: '1.0'
  description: 'Operations tagged reports across 2 of this provider''s published API definitions: mailchimp-marketing-api-openapi-original.json, mailchimp-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://server.api.mailchimp.com/3.0
- description: Mailchimp API
  url: https://api.mailchimp.com
tags:


# --- truncated at 32 KB (929 KB total) ---
# Full source: https://artifacts.apis.io/mailchimp/openapi/mailchimp-reports-api-openapi.yml