# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Mailchimp Marketing Reports API version: 1.0.0 extends: openapi/mailchimp-reports-api-openapi.yml actions: - target: $.info update: x-apievangelist-phrasing: method: generated generated: '2026-09-26' generator: build-phrasing.py label: Generated by API Evangelist operations: 22 - target: $.paths['/reports'].get update: x-apievangelist-phrasing: intent: List reports for sent campaigns effect: read questions: - Where can I see performance reports for all my sent campaigns? - Can I pull campaign reports only for campaigns sent in the last month? - Which of my sent campaigns have reports available? instructions: - text: List my campaign reports. - text: List reports for campaigns sent since {since_send_time}. slots: since_send_time: query.since_send_time - text: Show reports for {type} campaigns only. slots: type: query.type method: generated generated: '2026-09-26' - target: $.paths['/reports/{campaign_id}'].get update: x-apievangelist-phrasing: intent: Get the performance report for one campaign effect: read questions: - What were the open and click rates for a specific campaign I sent? - How did one particular campaign perform overall? instructions: - text: Get the report for campaign {campaign_id}. slots: campaign_id: path.campaign_id - text: Summarize the overall results of sent campaign {campaign_id}. slots: campaign_id: path.campaign_id method: generated generated: '2026-09-26' - target: $.paths['/reports/{campaign_id}/abuse-reports'].get update: x-apievangelist-phrasing: intent: List spam complaints for a campaign effect: read questions: - Did anyone mark my campaign as spam? - How many abuse complaints did a campaign receive? instructions: - text: List the abuse complaints for campaign {campaign_id}. slots: campaign_id: path.campaign_id - text: Show who reported campaign {campaign_id} as spam. slots: campaign_id: path.campaign_id method: generated generated: '2026-09-26' - target: $.paths['/reports/{campaign_id}/abuse-reports/{report_id}'].get update: x-apievangelist-phrasing: intent: Get one abuse complaint on a campaign effect: read questions: - Can I see the details of a single spam complaint on a campaign? - When was a specific abuse report filed and by which member? instructions: - text: Get abuse report {report_id} for campaign {campaign_id}. slots: report_id: path.report_id campaign_id: path.campaign_id - text: Show the details of spam complaint {report_id} on campaign {campaign_id}. slots: report_id: path.report_id campaign_id: path.campaign_id method: generated generated: '2026-09-26' - target: $.paths['/reports/{campaign_id}/advice'].get update: x-apievangelist-phrasing: intent: Get improvement advice from a campaign's stats effect: read questions: - What advice does Mailchimp give based on how my campaign performed? - Are there suggestions for improving a campaign given its opens, clicks and bounces? instructions: - text: Get the performance advice for campaign {campaign_id}. slots: campaign_id: path.campaign_id - text: Show stats-based recommendations for campaign {campaign_id}. slots: campaign_id: path.campaign_id method: generated generated: '2026-09-26' - target: $.paths['/reports/{campaign_id}/click-details'].get update: x-apievangelist-phrasing: intent: List link click stats for a campaign effect: read questions: - Which links in my campaign got the most clicks? - Can I exclude bot clicks when looking at link performance? instructions: - text: List click counts for every link in campaign {campaign_id}. slots: campaign_id: path.campaign_id - text: Show link clicks for campaign {campaign_id} with bot filtering set to {filter_bots}. slots: campaign_id: path.campaign_id filter_bots: query.filter_bots method: generated generated: '2026-09-26' - target: $.paths['/reports/{campaign_id}/click-details/{link_id}'].get update: x-apievangelist-phrasing: intent: Get click stats for one link in a campaign effect: read questions: - How many people clicked one particular link in my email? - What's the click total for a single tracked URL in a campaign? instructions: - text: Get click details for link {link_id} in campaign {campaign_id}. slots: link_id: path.link_id campaign_id: path.campaign_id - text: Show human-only clicks on link {link_id} of campaign {campaign_id}. slots: link_id: path.link_id campaign_id: path.campaign_id method: generated generated: '2026-09-26' - target: $.paths['/reports/{campaign_id}/click-details/{link_id}/members'].get update: x-apievangelist-phrasing: intent: List subscribers who clicked a campaign link effect: read questions: - 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? instructions: - text: List the subscribers who clicked link {link_id} in campaign {campaign_id}. slots: link_id: path.link_id campaign_id: path.campaign_id - text: Show the first {count} members who clicked link {link_id} in campaign {campaign_id}. slots: count: query.count link_id: path.link_id campaign_id: path.campaign_id method: generated generated: '2026-09-26' - target: $.paths['/reports/{campaign_id}/click-details/{link_id}/members/{subscriber_hash}'].get update: x-apievangelist-phrasing: intent: Get one subscriber's clicks on a campaign link effect: read questions: - Did a particular subscriber click a specific link in my campaign? - How many times did one member click a given link? instructions: - text: Get the clicks by subscriber {subscriber_hash} on link {link_id} in campaign {campaign_id}. slots: subscriber_hash: path.subscriber_hash link_id: path.link_id campaign_id: path.campaign_id - text: Check whether member {subscriber_hash} clicked link {link_id} of campaign {campaign_id}. slots: subscriber_hash: path.subscriber_hash link_id: path.link_id campaign_id: path.campaign_id method: generated generated: '2026-09-26' - target: $.paths['/reports/{campaign_id}/open-details'].get update: x-apievangelist-phrasing: intent: List members who opened a campaign effect: read questions: - Who opened my campaign, and when? - Can I leave out Apple privacy proxy opens so I only see real human opens? - Which subscribers opened a campaign after a certain time? instructions: - text: List who opened campaign {campaign_id}. slots: campaign_id: path.campaign_id - text: List opens of campaign {campaign_id} that happened since {since}. slots: campaign_id: path.campaign_id since: query.since method: generated generated: '2026-09-26' - target: $.paths['/reports/{campaign_id}/open-details/{subscriber_hash}'].get update: x-apievangelist-phrasing: intent: Get one subscriber's opens of a campaign effect: read questions: - Did a specific subscriber open my campaign? - How many times did one member open a given email? instructions: - text: Get the open details for subscriber {subscriber_hash} in campaign {campaign_id}. slots: subscriber_hash: path.subscriber_hash campaign_id: path.campaign_id - text: Check if member {subscriber_hash} opened campaign {campaign_id}. slots: subscriber_hash: path.subscriber_hash campaign_id: path.campaign_id method: generated generated: '2026-09-26' - target: $.paths['/reports/{campaign_id}/domain-performance'].get update: x-apievangelist-phrasing: intent: Compare campaign results by email domain effect: read questions: - How did my campaign perform at Gmail versus other email domains? - Which recipient email domains had the best results for a campaign? instructions: - text: Show domain performance stats for campaign {campaign_id}. slots: campaign_id: path.campaign_id - text: Break down campaign {campaign_id} results by recipient email domain. slots: campaign_id: path.campaign_id method: generated generated: '2026-09-26' - target: $.paths['/reports/{campaign_id}/eepurl'].get update: x-apievangelist-phrasing: intent: Get social sharing activity for a campaign effect: read questions: - How much social activity did my campaign's EepURL generate? - Were there clicks or referrers from people sharing my campaign link? instructions: - text: Get the EepURL social activity for campaign {campaign_id}. slots: campaign_id: path.campaign_id - text: Show sharing and referrer stats for campaign {campaign_id}'s short link. slots: campaign_id: path.campaign_id method: generated generated: '2026-09-26' - target: $.paths['/reports/{campaign_id}/email-activity'].get update: x-apievangelist-phrasing: intent: List every recipient's activity in a campaign effect: read questions: - Can I get a per-subscriber log of opens, clicks and bounces for a campaign? - What email activity happened in a campaign since yesterday? instructions: - text: List all recipient activity for campaign {campaign_id}. slots: campaign_id: path.campaign_id - text: List member activity in campaign {campaign_id} since {since}, excluding bots. slots: campaign_id: path.campaign_id since: query.since method: generated generated: '2026-09-26' - target: $.paths['/reports/{campaign_id}/email-activity/{subscriber_hash}'].get update: x-apievangelist-phrasing: intent: Get one member's full activity in a campaign effect: read questions: - 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? instructions: - text: Get the email activity of subscriber {subscriber_hash} in campaign {campaign_id}. slots: subscriber_hash: path.subscriber_hash campaign_id: path.campaign_id - text: Show every open, click and bounce for member {subscriber_hash} on campaign {campaign_id}. slots: subscriber_hash: path.subscriber_hash campaign_id: path.campaign_id method: generated generated: '2026-09-26' - target: $.paths['/reports/{campaign_id}/locations'].get update: x-apievangelist-phrasing: intent: See where a campaign was opened geographically effect: read questions: - Which countries opened my campaign the most? - Where in the world are people reading my email? instructions: - text: List the top open locations for campaign {campaign_id}. slots: campaign_id: path.campaign_id - text: Show the geographic breakdown of opens for campaign {campaign_id}. slots: campaign_id: path.campaign_id method: generated generated: '2026-09-26' - target: $.paths['/reports/{campaign_id}/sent-to'].get update: x-apievangelist-phrasing: intent: List everyone a campaign was sent to effect: read questions: - Who received my campaign? - Can I page through the full recipient list of a sent campaign? instructions: - text: List the recipients of campaign {campaign_id}. slots: campaign_id: path.campaign_id - text: Show {count} recipients of campaign {campaign_id} starting at offset {offset}. slots: count: query.count campaign_id: path.campaign_id offset: query.offset method: generated generated: '2026-09-26' - target: $.paths['/reports/{campaign_id}/sent-to/{subscriber_hash}'].get update: x-apievangelist-phrasing: intent: Get delivery info for one campaign recipient effect: read questions: - Was my campaign actually delivered to a particular subscriber? - What's the send status for one recipient of a campaign? instructions: - text: Get recipient info for {subscriber_hash} in campaign {campaign_id}. slots: subscriber_hash: path.subscriber_hash campaign_id: path.campaign_id - text: Check delivery status of campaign {campaign_id} for recipient {subscriber_hash}. slots: campaign_id: path.campaign_id subscriber_hash: path.subscriber_hash method: generated generated: '2026-09-26' - target: $.paths['/reports/{campaign_id}/sub-reports'].get update: x-apievangelist-phrasing: intent: List child campaign reports for a parent campaign effect: read questions: - 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? instructions: - text: List the child campaign reports for parent campaign {campaign_id}. slots: campaign_id: path.campaign_id - text: Show sub-reports belonging to campaign {campaign_id}. slots: campaign_id: path.campaign_id method: generated generated: '2026-09-26' - target: $.paths['/reports/{campaign_id}/unsubscribed'].get update: x-apievangelist-phrasing: intent: List members who unsubscribed from a campaign effect: read questions: - Who unsubscribed after receiving my campaign? - How many people opted out because of a specific email? instructions: - text: List the members who unsubscribed from campaign {campaign_id}. slots: campaign_id: path.campaign_id - text: Show opt-outs caused by campaign {campaign_id}. slots: campaign_id: path.campaign_id method: generated generated: '2026-09-26' - target: $.paths['/reports/{campaign_id}/unsubscribed/{subscriber_hash}'].get update: x-apievangelist-phrasing: intent: Get one member's unsubscribe from a campaign effect: read questions: - Did a specific subscriber unsubscribe from my campaign, and why? - When did one member opt out through a particular campaign? instructions: - text: Get unsubscribe details for member {subscriber_hash} from campaign {campaign_id}. slots: subscriber_hash: path.subscriber_hash campaign_id: path.campaign_id - text: Show the reason member {subscriber_hash} left via campaign {campaign_id}. slots: subscriber_hash: path.subscriber_hash campaign_id: path.campaign_id method: generated generated: '2026-09-26' - target: $.paths['/reports/{campaign_id}/ecommerce-product-activity'].get update: x-apievangelist-phrasing: intent: See product sales driven by a campaign effect: read questions: - Which products did people buy after clicking my campaign? - How much ecommerce revenue per product came from a campaign? instructions: - text: List product activity for campaign {campaign_id}. slots: campaign_id: path.campaign_id - text: Show product purchases from campaign {campaign_id} sorted by {sort_field}. slots: campaign_id: path.campaign_id sort_field: query.sort_field method: generated generated: '2026-09-26'