> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://mailchimp.com/developer/marketing/api/automations/list-emails/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://mailchimp.com/_mcp/server.

# List automated emails

GET https://api.mailchimp.com/3.0/automations/{workflow_id}/emails

Get a summary of the emails in a classic automation workflow.

Reference: https://mailchimp.com/developer/marketing/api/automations/list-emails

## Authentication

- `Authorization` header (bearer token, required) — Authorization using a Mailchimp API key (a.k.a. Bearer token)
- `Authorization` header (bearer token, required) — Authorization using OAuth

## Request

### Path parameters

- `workflow_id` (string, required) — The unique id for the Automation workflow.

## Response

### 200

- `_links` (list of list of 30AutomationsWorkflowIdEmailsGetResponsesContentApplicationJsonSchemaLinksItemsItems, optional) — A list of link types and descriptions for the API schema documents.
- `emails` (list of AutomationWorkflowEmail, optional) — An array of objects, each representing an email in an Automation workflow.
- `total_items` (integer, optional) — The total number of items matching the query regardless of pagination.

## Types

### 30AutomationsWorkflowIdEmailsGetResponsesContentApplicationJsonSchemaLinksItemsItems

This object represents a link from the resource where it is found to another resource or action that may be performed.

- `href` (string, optional) — This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action.
- `method` (enum, optional) — The HTTP method that should be used when accessing the URL defined in 'href'.
  - Allowed values: `GET`, `POST`, `PUT`, `PATCH`, `DELETE`, `OPTIONS`, `HEAD`
- `rel` (string, optional) — As with an HTML 'rel' attribute, this describes the type of link.
- `schema` (string, optional) — For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to.
- `targetSchema` (string, optional) — For GETs, this is a URL representing the schema that the response should conform to.

### AutomationWorkflowEmail

A summary of an individual Automation workflow email.

- `_links` (list of AutomationWorkflowEmailLinksItems, optional) — A list of link types and descriptions for the API schema documents.
- `archive_url` (string, optional) — The link to the campaign's archive version in ISO 8601 format.
- `content_type` (string, optional) — How the campaign's content is put together ('template', 'drag_and_drop', 'html', 'url').
- `create_time` (datetime, optional) — The date and time the campaign was created in ISO 8601 format.
- `delay` (AutomationWorkflowEmailDelay, optional) — The delay settings for an Automation email.
- `emails_sent` (integer, optional) — The total number of emails sent for this campaign.
- `has_logo_merge_tag` (boolean, optional) — Determines if the campaign contains the *|BRAND:LOGO|* merge tag.
- `id` (string, optional) — A string that uniquely identifies the Automation email.
- `needs_block_refresh` (boolean, optional) — Determines if the automation email needs its blocks refreshed by opening the web-based campaign editor.
- `position` (integer, optional) — The position of an Automation email in a workflow.
- `recipients` (AutomationWorkflowEmailRecipients, optional) — List settings for the campaign.
- `report_summary` (AutomationWorkflowEmailReportSummary, optional) — For sent campaigns, a summary of opens and clicks.
- `send_time` (datetime, optional) — The date and time a campaign was sent in ISO 8601 format
- `settings` (AutomationWorkflowEmailSettings, optional) — Settings for the campaign including the email subject, from name, and from email address.
- `social_card` (AutomationWorkflowEmailSocialCard, optional) — The preview for the campaign, rendered by social networks like Facebook and Twitter. [Learn more](https://mailchimp.com/help/enable-and-customize-social-cards/).
- `start_time` (datetime, optional) — The date and time the campaign was started in ISO 8601 format.
- `status` (enum, optional) — The current status of the campaign.
  - Allowed values: `save`, `paused`, `sending`
- `tracking` (AutomationWorkflowEmailTracking, optional) — The tracking options for a campaign.
- `trigger_settings` (AutomationWorkflowEmailTriggerSettings, optional) — Available triggers for Automation workflows.
- `web_id` (integer, optional) — The ID used in the Mailchimp web application. View this automation in your Mailchimp account at `https://{dc}.admin.mailchimp.com/campaigns/show/?id={web_id}`.
- `workflow_id` (string, optional) — A string that uniquely identifies an Automation workflow.

### AutomationWorkflowEmailLinksItems

This object represents a link from the resource where it is found to another resource or action that may be performed.

- `href` (string, optional) — This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action.
- `method` (enum, optional) — The HTTP method that should be used when accessing the URL defined in 'href'.
  - Allowed values: `GET`, `POST`, `PUT`, `PATCH`, `DELETE`, `OPTIONS`, `HEAD`
- `rel` (string, optional) — As with an HTML 'rel' attribute, this describes the type of link.
- `schema` (string, optional) — For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to.
- `targetSchema` (string, optional) — For GETs, this is a URL representing the schema that the response should conform to.

### AutomationWorkflowEmailDelay

The delay settings for an Automation email.

- `action` (enum, optional) — The action that triggers the delay of an Automation email.
  - Allowed values: `previous_campaign_sent`, `previous_campaign_opened`, `previous_campaign_not_opened`, `previous_campaign_clicked_any`, `previous_campaign_not_clicked_any`, `previous_campaign_specific_clicked`, `ecomm_bought_any`, `ecomm_bought_product`, `ecomm_bought_category`, `ecomm_not_bought_any`, `ecomm_abandoned_cart`, `campaign_sent`, `opened_email`, `not_opened_email`, `clicked_email`, `not_clicked_email`, `campaign_specific_clicked`, `manual`, `signup`, `merge_changed`, `group_add`, `group_remove`, `mandrill_sent`, `mandrill_opened`, `mandrill_clicked`, `mandrill_any`, `api`, `goal`, `annual`, `birthday`, `date`, `date_added`, `tag_add`
- `action_description` (string, optional) — The user-friendly description of the action that triggers an Automation email.
- `amount` (integer, optional) — The delay amount for an Automation email.
- `direction` (enum, optional) — Whether the delay settings describe before or after the delay action of an Automation email.
  - Allowed values: `before`, `after`
- `full_description` (string, optional) — The user-friendly description of the delay and trigger action settings for an Automation email.
- `type` (enum, optional) — The type of delay for an Automation email.
  - Allowed values: `now`, `day`, `hour`, `week`

### AutomationWorkflowEmailRecipients

List settings for the campaign.

- `list_id` (string, optional) — The unique list id.
- `list_is_active` (boolean, optional) — The status of the list used, namely if it's deleted or disabled.
- `list_name` (string, optional) — The name of the list.
- `recipient_count` (integer, optional) — Count of the recipients on the associated list. Formatted as an integer.
- `segment_opts` (AutomationWorkflowEmailRecipientsSegmentOpts, optional) — An object representing all segmentation options. This object should contain a `saved_segment_id` to use an existing segment, or you can create a new segment by including both `match` and `conditions` options.
- `segment_text` (string, optional) — A description of the [segment](https://mailchimp.com/help/getting-started-with-groups/) used for the campaign. Formatted as a string marked up with HTML.

### AutomationWorkflowEmailReportSummary

For sent campaigns, a summary of opens and clicks.

- `click_rate` (double, optional) — The number of unique clicks divided by the total number of successful deliveries.
- `clicks` (integer, optional) — The total number of clicks for an campaign.
- `open_rate` (double, optional) — The number of unique opens divided by the total number of successful deliveries.
- `opens` (integer, optional) — The total number of opens for a campaign.
- `subscriber_clicks` (integer, optional) — The number of unique clicks.
- `unique_opens` (integer, optional) — The number of unique opens.

### AutomationWorkflowEmailSettings

Settings for the campaign including the email subject, from name, and from email address.

- `authenticate` (boolean, optional) — Whether Mailchimp [authenticated](https://mailchimp.com/help/about-email-authentication/) the campaign. Defaults to `true`.
- `auto_fb_post` (list of string, optional) — An array of [Facebook](https://mailchimp.com/help/connect-or-disconnect-the-facebook-integration/) page ids to auto-post to.
- `auto_footer` (boolean, optional) — Automatically append Mailchimp's [default footer](https://mailchimp.com/help/about-campaign-footers/) to the campaign.
- `auto_tweet` (boolean, optional) — Automatically tweet a link to the [campaign archive](https://mailchimp.com/help/about-email-campaign-archives-and-pages/) page when the campaign is sent.
- `drag_and_drop` (boolean, optional) — Whether the campaign uses the drag-and-drop editor.
- `fb_comments` (boolean, optional) — Allows Facebook comments on the campaign (also force-enables the Campaign Archive toolbar). Defaults to `true`.
- `from_name` (string, optional) — The 'from' name on the campaign (not an email address).
- `inline_css` (boolean, optional) — Automatically inline the CSS included with the campaign content.
- `preview_text` (string, optional) — The preview text for the campaign.
- `reply_to` (string, optional) — The reply-to email address for the campaign.
- `subject_line` (string, optional) — The subject line for the campaign.
- `template_id` (integer, optional) — The id for the template used in this campaign.
- `title` (string, optional) — The title of the campaign.

### AutomationWorkflowEmailSocialCard

The preview for the campaign, rendered by social networks like Facebook and Twitter. [Learn more](https://mailchimp.com/help/enable-and-customize-social-cards/).

- `description` (string, optional) — A short summary of the campaign to display.
- `image_url` (string, optional) — The url for the header image for the card.
- `title` (string, optional) — The title for the card. Typically the subject line of the campaign.

### AutomationWorkflowEmailTracking

The tracking options for a campaign.

- `capsule` (AutomationWorkflowEmailTrackingCapsule, optional) — Deprecated
- `clicktale` (string, optional) — The custom slug for [Click Tale](https://mailchimp.com/help/additional-tracking-options-for-campaigns/) tracking (max of 50 bytes).
- `ecomm360` (boolean, optional) — Whether to enable e-commerce tracking.
- `goal_tracking` (boolean, optional) — Deprecated
- `google_analytics` (string, optional) — The custom slug for [Google Analytics](https://mailchimp.com/help/integrate-google-analytics-with-mailchimp/) tracking (max of 50 bytes).
- `html_clicks` (boolean, optional) — Whether to [track clicks](https://mailchimp.com/help/enable-and-view-click-tracking/) in the HTML version of the campaign. Defaults to `true`.
- `opens` (boolean, optional) — Whether to [track opens](https://mailchimp.com/help/about-open-tracking/). Defaults to `true`.
- `salesforce` (AutomationWorkflowEmailTrackingSalesforce, optional) — Deprecated
- `text_clicks` (boolean, optional) — Whether to [track clicks](https://mailchimp.com/help/enable-and-view-click-tracking/) in the plain-text version of the campaign. Defaults to `true`.

### AutomationWorkflowEmailTriggerSettings

Available triggers for Automation workflows.

- `workflow_type` (enum, required) — The type of Automation workflow.
  - Allowed values: `abandonedBrowse`, `abandonedCart`, `api`, `bestCustomers`, `categoryFollowup`, `dateAdded`, `emailFollowup`, `emailSeries`, `groupAdd`, `groupRemove`, `mandrill`, `productFollowup`, `purchaseFollowup`, `recurringEvent`, `specialEvent`, `visitUrl`, `welcomeSeries`
- `runtime` (AutomationWorkflowEmailTriggerSettingsRuntime, optional) — A workflow's runtime settings for an Automation.
- `workflow_emails_count` (integer, optional) — The number of emails in the Automation workflow.
- `workflow_title` (string, optional) — The title of the workflow type.

### AutomationWorkflowEmailRecipientsSegmentOpts

An object representing all segmentation options. This object should contain a `saved_segment_id` to use an existing segment, or you can create a new segment by including both `match` and `conditions` options.

- `conditions` (list of SegmentTypeItems, optional) — Segment match conditions. There are multiple possible types, see the [condition types documentation](https://mailchimp.com/developer/marketing/docs/alternative-schemas/#segment-condition-schemas).
- `match` (enum, optional) — Segment match type.
  - Allowed values: `any`, `all`
- `prebuilt_segment_id` (string, optional) — The prebuilt segment id, if a prebuilt segment has been designated for this campaign.
- `saved_segment_id` (AutomationWorkflowEmailRecipientsSegmentOptsSavedSegmentId, optional) — The id for an existing saved segment.

### AutomationWorkflowEmailTrackingCapsule

Deprecated

- `notes` (boolean, optional) — Update contact notes for a campaign based on a subscriber's email address.

### AutomationWorkflowEmailTrackingSalesforce

Deprecated

- `campaign` (boolean, optional) — Create a campaign in a connected Salesforce account.
- `notes` (boolean, optional) — Update contact notes for a campaign based on a subscriber's email address.

### AutomationWorkflowEmailTriggerSettingsRuntime

A workflow's runtime settings for an Automation.

- `days` (list of enum, optional) — The days an Automation workflow can send.
  - Allowed values: `sunday`, `monday`, `tuesday`, `wednesday`, `thursday`, `friday`, `saturday`
- `hours` (AutomationWorkflowEmailTriggerSettingsRuntimeHours, optional) — The hours an Automation workflow can send.

### SegmentTypeItems

### AutomationWorkflowEmailRecipientsSegmentOptsSavedSegmentId

The id for an existing saved segment.

### AutomationWorkflowEmailTriggerSettingsRuntimeHours

The hours an Automation workflow can send.

- `type` (enum, required) — When to send the Automation email.
  - Allowed values: `send_asap`, `send_between`, `send_at`

### Aim Segment

Segment by interaction with a specific campaign.

- `condition_type` (enum, optional)
  - Allowed values: `Aim`
- `field` (enum, optional) — Segment by interaction with a specific campaign.
  - Allowed values: `aim`
- `op` (enum, optional) — The status of the member with regard to their campaign interaction. One of the following: opened, clicked, was sent, didn't open, didn't click, or was not sent.
  - Allowed values: `open`, `click`, `sent`, `noopen`, `noclick`, `nosent`
- `value` (string, optional) — Either the web id value for a specific campaign or 'any' to account for subscribers who have/have not interacted with any campaigns.

### Automation Segment

Segment by interaction with an Automation workflow.

- `field` (enum, required) — Segment by interaction with an Automation workflow.
  - Allowed values: `automation`
- `op` (enum, required) — The status of the member with regard to the automation workflow. One of the following: has started the workflow, has completed the workflow, has not started the workflow, or has not completed the workflow.
  - Allowed values: `started`, `completed`, `not_started`, `not_completed`
- `value` (string, required) — The web id for the automation workflow to segment against.
- `condition_type` (enum, optional)
  - Allowed values: `Automation`

### Poll Activity Segment

Segment by poll activity.

- `field` (enum, required) — Segment by poll activity.
  - Allowed values: `poll`
- `op` (enum, required) — Members have/have not interacted with a specific poll in a Mailchimp email.
  - Allowed values: `member`, `notmember`
- `value` (double, required) — The id for the poll.
- `condition_type` (enum, optional)
  - Allowed values: `CampaignPoll`

### Conversation Segment

Segment by interaction with a campaign via Conversations.

- `field` (enum, required) — Segment by interaction with a campaign via Conversations.
  - Allowed values: `conversation`
- `op` (enum, required) — The status of a member's interaction with a conversation. One of the following: has replied or has not replied.
  - Allowed values: `member`, `notmember`
- `value` (string, required) — The web id value for a specific campaign or 'any' to account for subscribers who have/have not interacted with any campaigns.
- `condition_type` (enum, optional)
  - Allowed values: `Conversation`

### Date Segment

Segment by a specific date field.

- `field` (enum, required) — The type of date field to segment on: The opt-in time for a signup, the date the subscriber was last updated, or the date of their last ecomm purchase.
  - Allowed values: `timestamp_opt`, `info_changed`, `ecomm_date`
- `op` (enum, required) — When the event took place: Before, after, is a specific date, is not a specific date, is blank, or is not blank.
  - Allowed values: `greater`, `less`, `is`, `not`, `blank`, `blank_not`, `within`, `notwithin`
- `value` (string, required) — What type of data to segment on: a specific date, a specific campaign, or the last campaign sent.
- `condition_type` (enum, optional)
  - Allowed values: `Date`
- `extra` (string, optional) — When segmenting on 'date' or 'campaign', the date for the segment formatted as YYYY-MM-DD or the web id for the campaign.

### Email Client Segment

Segment by use of a particular email client.

- `field` (enum, required) — Segment by use of a particular email client.
  - Allowed values: `email_client`
- `op` (enum, required) — The operation to determine whether we select clients that match the value, or clients that do not match the value.
  - Allowed values: `client_is`, `client_not`
- `value` (string, required) — The name of the email client.
- `condition_type` (enum, optional)
  - Allowed values: `EmailClient`

### Language Segment

Segment by language.

- `field` (enum, required) — Segmenting based off of a subscriber's language.
  - Allowed values: `language`
- `op` (enum, required) — Whether the member's language is or is not set to a specific language.
  - Allowed values: `is`, `not`
- `value` (string, required) — A two-letter language identifier.
- `condition_type` (enum, optional)
  - Allowed values: `Language`

### Member Rating Segment

Segment by member rating.

- `field` (enum, required) — Segment by member rating.
  - Allowed values: `rating`
- `op` (enum, required) — Members who have have a rating that is/not exactly a given number or members who have a rating greater/less than a given number.
  - Allowed values: `is`, `not`, `greater`, `less`
- `value` (SegmentTypeItemsOneOf7Value, required)
- `condition_type` (enum, optional)
  - Allowed values: `MemberRating`

### Signup Source Segment

Segment by signup source.

- `condition_type` (enum, required)
  - Allowed values: `SignupSource`
- `field` (enum, required)
  - Allowed values: `source`
- `op` (enum, required) — Whether the member's signup source was/was not a particular value.
  - Allowed values: `source_is`, `source_not`
- `value` (string, optional) — The signup source.

### Survey Monkey Segment

Segment by interaction with a SurveyMonkey survey.

- `field` (enum, required) — Segment by interaction with a SurveyMonkey survey.
  - Allowed values: `survey_monkey`
- `op` (enum, required) — The status of the member with regard to the survey.One of the following: has started the survey, has completed the survey, has not started the survey, or has not completed the survey.
  - Allowed values: `started`, `completed`, `not_started`, `not_completed`
- `value` (string, required) — The unique ID of the survey monkey survey.
- `condition_type` (enum, optional)
  - Allowed values: `SurveyMonkey`

### VIP Segment

Segment by VIP status.

- `field` (enum, required) — Segment by VIP status.
  - Allowed values: `gmonkey`
- `op` (enum, required) — Whether the member is or is not marked as VIP.
  - Allowed values: `member`, `notmember`
- `condition_type` (enum, optional)
  - Allowed values: `VIP`

### Interests Segment

Segment by an interest group merge field.

- `condition_type` (enum, optional)
  - Allowed values: `Interests`
- `field` (string, optional) — Segmenting based on interest group information. This should start with 'interests-' followed by the grouping id. Ex. 'interests-123'.
- `op` (enum, optional) — Whether the member is a part of one, all, or none of the groups.
  - Allowed values: `interestcontains`, `interestcontainsall`, `interestnotcontains`
- `value` (list of string, optional) — An array containing strings, each representing a group id.

### Ecommerce Category Segment

Segment by purchases in specific items or categories.

- `condition_type` (enum, optional)
  - Allowed values: `EcommCategory`
- `field` (enum, optional) — Segment by purchases in specific items or categories.
  - Allowed values: `ecomm_cat`, `ecomm_prod`
- `op` (enum, optional) — A member who has purchased from a category/specific item that is/is not a specific name, where the category/item name contains/doesn't contain a specific phrase or string, or a category/item name that starts/ends with a string.
  - Allowed values: `is`, `not`, `contains`, `notcontain`, `starts`, `ends`
- `value` (string, optional) — The ecommerce category/item information.

### Ecommerce Number Segment

Segment by average spent total, number of orders, total number of products purchased, or average number of products per order.

- `field` (enum, required) — Segment by average spent total, number of orders, total number of products purchased, or average number of products per order.
  - Allowed values: `ecomm_spent_avg`, `ecomm_orders`, `ecomm_prod_all`, `ecomm_avg_ord`
- `op` (enum, required) — Members who have spent exactly, have not spent exactly, spent more, or spent less than the segment value.
  - Allowed values: `is`, `not`, `greater`, `less`
- `value` (SegmentTypeItemsOneOf13Value, required)
- `condition_type` (enum, optional)
  - Allowed values: `EcommNumber`

### Ecommerce Purchased Segment

Segment by whether someone has purchased anything.

- `condition_type` (enum, optional)
  - Allowed values: `EcommPurchased`
- `field` (enum, optional) — Segment by whether someone has purchased anything.
  - Allowed values: `ecomm_purchased`
- `op` (enum, optional) — Members who have have ('member') or have not ('notmember') purchased.
  - Allowed values: `member`, `notmember`

### Ecommerce Spent Segment

Segment by amount spent on a single order or across all orders.

- `condition_type` (enum, optional)
  - Allowed values: `EcommSpent`
- `field` (enum, optional) — Segment by amount spent on a single order or across all orders.
  - Allowed values: `ecomm_spent_one`, `ecomm_spent_all`
- `op` (enum, optional) — Members who have spent 'more' or 'less' than then specified value.
  - Allowed values: `greater`, `less`
- `value` (SegmentTypeItemsOneOf15Value, optional)

### Ecommerce Purchased Store Segment

Segment by purchases from a specific store.

- `condition_type` (enum, optional)
  - Allowed values: `EcommStore`
- `field` (enum, optional) — Segment by purchases from a specific store.
  - Allowed values: `ecomm_store`
- `op` (enum, optional) — Members who have or have not purchased from a specific store.
  - Allowed values: `is`, `not`
- `value` (string, optional) — The store id to segment against.

### Goal Activity Segment

Segment by Goal activity.

- `field` (enum, required) — Segment by Goal activity.
  - Allowed values: `goal`
- `op` (enum, required) — Whether the website URL is/not exactly, contains/doesn't contain, starts with/ends with a string.
  - Allowed values: `is`, `goal_not`, `contains`, `goal_notcontain`, `starts`, `ends`
- `value` (string, required) — The URL to check Goal activity against.
- `condition_type` (enum, optional)
  - Allowed values: `GoalActivity`

### Goal Timestamp Segment

Segment by most recent interaction with a website.

- `field` (enum, required) — Segment by most recent interaction with a website.
  - Allowed values: `goal_last_visited`
- `op` (enum, required) — Whether the website activity happened after, before, or at a given timestamp.
  - Allowed values: `greater`, `less`, `is`
- `value` (string, required) — The date to check Goal activity against.
- `condition_type` (enum, optional)
  - Allowed values: `GoalTimestamp`

### Similar Subscribers Segment Member Segment

Segment by similar subscribers.

- `field` (enum, required) — Segment by similar subscribers.
  - Allowed values: `fuzzy_segment`
- `op` (enum, required) — Members who are/are not apart of a 'similar subscribers' segment.
  - Allowed values: `fuzzy_is`, `fuzzy_not`
- `value` (SegmentTypeItemsOneOf19Value, required)
- `condition_type` (enum, optional)
  - Allowed values: `FuzzySegment`

### Static Segment Member Segment

Segment by a given static segment.

- `field` (enum, required) — Segment by a given static segment.
  - Allowed values: `static_segment`
- `op` (enum, required) — Members who are/are not apart of a static segment.
  - Allowed values: `static_is`, `static_not`
- `value` (SegmentTypeItemsOneOf20Value, required)
- `condition_type` (enum, optional)
  - Allowed values: `StaticSegment`

### Location-Based Segment

Segment by a specific country or US state.

- `field` (enum, required) — Segmenting subscribers who are within a specific location.
  - Allowed values: `ipgeo`
- `op` (enum, required) — Segment members who are within a specific country or US state.
  - Allowed values: `ipgeocountry`, `ipgeonotcountry`, `ipgeostate`, `ipgeonotstate`
- `value` (string, required) — The two-letter country code or US state abbreviation.
- `condition_type` (enum, optional)
  - Allowed values: `IPGeoCountryState`

### Geolocation Segment

Segment by a specific geographic region.

- `addr` (string, required) — The address of the target location.
- `field` (enum, required) — Segmenting subscribers who are within a specific location.
  - Allowed values: `ipgeo`
- `lat` (string, required) — The latitude of the target location.
- `lng` (string, required) — The longitude of the target location.
- `op` (enum, required) — Segment members who are within a specific geographic region.
  - Allowed values: `ipgeoin`, `ipgeonotin`
- `value` (integer, required) — The radius of the target location.
- `condition_type` (enum, optional)
  - Allowed values: `IPGeoIn`

### US Zip Code Segment

Segment by a specific US ZIP code.

- `extra` (integer, required) — The zip code to segment against.
- `field` (enum, required) — Segmenting subscribers who are within a specific location.
  - Allowed values: `ipgeo`
- `op` (enum, required) — Segment members who are within a specific US zip code.
  - Allowed values: `ipgeoinzip`
- `value` (integer, required) — The radius of the target location.
- `condition_type` (enum, optional)
  - Allowed values: `IPGeoInZip`

### Unknown Location-Based Segment

Segment members whose location information is unknown.

- `field` (enum, required) — Segmenting subscribers who are within a specific location.
  - Allowed values: `ipgeo`
- `op` (enum, required) — Segment members for which location information is unknown.
  - Allowed values: `ipgeounknown`
- `condition_type` (enum, optional)
  - Allowed values: `IPGeoUnknown`

### Zip Code Location-Based Segment

Segment by a specific US ZIP code.

- `field` (enum, required) — Segmenting subscribers who are within a specific location.
  - Allowed values: `ipgeo`
- `op` (enum, required) — Segment members who are/are not within a specific US zip code.
  - Allowed values: `ipgeoiszip`, `ipgeonotzip`
- `value` (integer, required) — The 5-digit zip code.
- `condition_type` (enum, optional)
  - Allowed values: `IPGeoZip`

### Social Profiles Age Segment

Segment by age ranges in Social Profiles data.

- `field` (enum, required) — Segment by age ranges in Social Profiles data.
  - Allowed values: `social_age`
- `op` (enum, required) — Members who are/not the exact criteria listed.
  - Allowed values: `is`, `not`
- `value` (enum, required) — The age range to segment.
  - Allowed values: `18-24`, `25-34`, `35-54`, `55+`
- `condition_type` (enum, optional)
  - Allowed values: `SocialAge`

### Social Profiles Gender Segment

Segment by listed gender in Social Profiles data.

- `field` (enum, required) — Segment by listed gender in Social Profiles data.
  - Allowed values: `social_gender`
- `op` (enum, required) — Members who are/not the exact criteria listed.
  - Allowed values: `is`, `not`
- `value` (enum, required) — The Social Profiles gender to segment.
  - Allowed values: `male`, `female`
- `condition_type` (enum, optional)
  - Allowed values: `SocialGender`

### Social Profiles Influence Segment

Segment by influence rating in Social Profiles data.

- `field` (enum, required) — Segment by influence rating in Social Profiles data.
  - Allowed values: `social_influence`
- `op` (enum, required) — Members who have a rating that is/not or greater/less than the rating provided.
  - Allowed values: `is`, `not`, `greater`, `less`
- `value` (double, required) — The Social Profiles influence rating to segment.
- `condition_type` (enum, optional)
  - Allowed values: `SocialInfluence`

### Social Profiles Social Network Segment

Segment by social network in Social Profiles data.

- `field` (enum, required) — Segment by social network in Social Profiles data.
  - Allowed values: `social_network`
- `op` (enum, required) — Members who are/not on a given social network.
  - Allowed values: `member`, `notmember`
- `value` (enum, required) — The social network to segment against.
  - Allowed values: `twitter`, `facebook`, `linkedin`, `flickr`, `foursquare`, `lastfm`, `myspace`, `quora`, `vimeo`, `yelp`, `youtube`
- `condition_type` (enum, optional)
  - Allowed values: `SocialNetworkMember`

### Social Profiles Social Network Follow Segment

Segment by social network in Social Profiles data.

- `field` (enum, required) — Segment by social network in Social Profiles data.
  - Allowed values: `social_network`
- `op` (enum, required) — Members who are/not following a linked account on a given social network.
  - Allowed values: `follow`, `notfollow`
- `value` (enum, required) — The social network to segment against.
  - Allowed values: `twitter_follow`
- `condition_type` (enum, optional)
  - Allowed values: `SocialNetworkFollow`

### Address Merge Field Segment

Segment by an address-type merge field.

- `field` (string, required) — An address-type merge field to segment.
- `op` (enum, required) — Whether the member's address merge field contains/does not contain a value or is/is not blank.
  - Allowed values: `contains`, `notcontain`, `blank`, `blank_not`
- `condition_type` (enum, optional)
  - Allowed values: `AddressMerge`
- `value` (string, optional) — The value to segment a text merge field with.

### Address/Zip Merge Field Segment

Segment by an address-type merge field within a given distance.

- `extra` (string, required) — The city or the zip being used to segment against.
- `field` (string, required) — An address or zip-type merge field to segment.
- `op` (enum, required) — Whether the member's address merge field is within a given distance from a city or zip.
  - Allowed values: `geoin`
- `value` (string, required) — The distance from the city/zip.
- `condition_type` (enum, optional)
  - Allowed values: `ZipMerge`

### Birthday Merge Field Segment

Segment by a contact's birthday.

- `field` (string, required) — A date merge field to segment.
- `op` (enum, required) — Whether the member's birthday merge information is/is not a certain date or is/is not blank.
  - Allowed values: `is`, `not`, `blank`, `blank_not`
- `condition_type` (enum, optional)
  - Allowed values: `BirthdayMerge`
- `value` (string, optional) — A date to segment against (mm/dd).

### Date Merge Field Segment

Segment by a given date merge field.

- `field` (string, required) — A date merge field to segment.
- `op` (enum, required) — Whether the member's merge information is/is not, is greater/less than a value or is/is not blank.
  - Allowed values: `is`, `not`, `less`, `blank`, `blank_not`, `greater`
- `condition_type` (enum, optional)
  - Allowed values: `DateMerge`
- `value` (string, optional) — A date to segment against.

### Dropdown/Radio Merge Field Segment

An individual segment condition

- `field` (string, required) — A merge field to segment.
- `op` (enum, required) — Whether the member's merge information is/is not a value or is/is not blank.
  - Allowed values: `is`, `not`, `blank`, `blank_not`, `notcontain`, `contains`
- `condition_type` (enum, optional)
  - Allowed values: `SelectMerge`
- `value` (string, optional) — The value to segment a text merge field with.

### Text or Number Merge Field Segment

Segment by a given text or number merge field.

- `field` (string, required) — A text or number merge field to segment.
- `op` (enum, required) — Whether the member's merge information is/is not, contains/does not contain, starts/ends with, or is greater/less than a value
  - Allowed values: `is`, `not`, `contains`, `notcontain`, `starts`, `ends`, `greater`, `less`, `blank`, `blank_not`
- `condition_type` (enum, optional)
  - Allowed values: `TextMerge`
- `value` (string, optional) — The value to segment a text or number merge field with.

### Email Segment

Segment by email address.

- `field` (enum, required) — Segmenting based off of a subscriber's email address.
  - Allowed values: `merge0`, `EMAIL`
- `op` (enum, required) — Whether the email address is/not exactly, contains/doesn't contain, starts/ends with a string.
  - Allowed values: `is`, `not`, `contains`, `notcontain`, `starts`, `ends`, `greater`, `less`
- `condition_type` (enum, optional)
  - Allowed values: `EmailAddress`
- `value` (string, optional) — The value to compare the email against.

### Predicted Gender Segment

Segment by predicted gender.

- `field` (enum, required) — Segment by predicted gender.
  - Allowed values: `predicted_gender`
- `op` (enum, required) — Members who are/not the exact criteria listed.
  - Allowed values: `is`, `not`
- `value` (enum, required) — The predicted gender to segment.
  - Allowed values: `male`, `female`
- `condition_type` (enum, optional)
  - Allowed values: `PredictedGender`

### Predicted Age Segment

Segment by predicted age.

- `field` (enum, required) — Segment by predicted age.
  - Allowed values: `predicted_age_range`
- `op` (enum, required) — Members who are/not the exact criteria listed.
  - Allowed values: `is`
- `value` (enum, required) — The predicted age to segment.
  - Allowed values: `18-24`, `25-34`, `35-44`, `45-54`, `55-64`, `65+`
- `condition_type` (enum, optional)
  - Allowed values: `PredictedAge`

### New Subscribers Prebuilt Segment

Segment by when people subscribed.

- `condition_type` (enum, optional)
  - Allowed values: `NewSubscribers`
- `field` (enum, optional) — Segment by when people subscribed.
  - Allowed values: `timestamp_opt`
- `op` (enum, optional) — Whe the event took place, namely within a time frame.
  - Allowed values: `date_within`
- `value` (string, optional) — What type of data to segment on: a specific date, a specific campaign, or the last campaign sent.

### SegmentTypeItemsOneOf7Value

### SegmentTypeItemsOneOf13Value

### SegmentTypeItemsOneOf15Value

### SegmentTypeItemsOneOf19Value

### SegmentTypeItemsOneOf20Value

## Examples

**Response**

```json
{
  "_links": [
    [
      {
        "href": "string",
        "method": "GET",
        "rel": "string",
        "schema": "string",
        "targetSchema": "string"
      }
    ]
  ],
  "emails": [
    {
      "_links": [
        {
          "href": "string",
          "method": "GET",
          "rel": "string",
          "schema": "string",
          "targetSchema": "string"
        }
      ],
      "archive_url": "string",
      "content_type": "string",
      "create_time": "2024-01-15T09:30:00Z",
      "delay": {
        "action": "previous_campaign_sent",
        "action_description": "subscribers purchase anything from your store",
        "amount": 1,
        "direction": "before",
        "full_description": "1 day after subscribers purchase anything from your store",
        "type": "now"
      },
      "emails_sent": 1,
      "has_logo_merge_tag": true,
      "id": "string",
      "needs_block_refresh": true,
      "position": 1,
      "recipients": {
        "list_id": "string",
        "list_is_active": true,
        "list_name": "string",
        "recipient_count": 1,
        "segment_opts": {
          "conditions": [
            {
              "condition_type": "Aim",
              "field": "aim",
              "op": "open",
              "value": "any"
            }
          ],
          "match": "any",
          "prebuilt_segment_id": "subscribers-female",
          "saved_segment_id": 1
        },
        "segment_text": "string"
      },
      "report_summary": {
        "click_rate": 1.1,
        "clicks": 1,
        "open_rate": 1.1,
        "opens": 1,
        "subscriber_clicks": 1,
        "unique_opens": 1
      },
      "send_time": "2024-01-15T09:30:00Z",
      "settings": {
        "authenticate": true,
        "auto_fb_post": [
          "string"
        ],
        "auto_footer": true,
        "auto_tweet": true,
        "drag_and_drop": true,
        "fb_comments": true,
        "from_name": "string",
        "inline_css": true,
        "preview_text": "string",
        "reply_to": "string",
        "subject_line": "string",
        "template_id": 1,
        "title": "string"
      },
      "social_card": {
        "description": "string",
        "image_url": "string",
        "title": "string"
      },
      "start_time": "2024-01-15T09:30:00Z",
      "status": "save",
      "tracking": {
        "capsule": {
          "notes": true
        },
        "clicktale": "string",
        "ecomm360": true,
        "goal_tracking": true,
        "google_analytics": "string",
        "html_clicks": true,
        "opens": true,
        "salesforce": {
          "campaign": true,
          "notes": true
        },
        "text_clicks": true
      },
      "trigger_settings": {
        "workflow_type": "abandonedBrowse",
        "runtime": {
          "days": [
            "sunday"
          ],
          "hours": {
            "type": "send_asap"
          }
        },
        "workflow_emails_count": 1,
        "workflow_title": "string"
      },
      "web_id": 33345484,
      "workflow_id": "string"
    }
  ],
  "total_items": 1
}
```

**SDK Code**

```python
import requests

url = "https://api.mailchimp.com/3.0/automations/workflow_id/emails"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript
const url = 'https://api.mailchimp.com/3.0/automations/workflow_id/emails';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.mailchimp.com/3.0/automations/workflow_id/emails"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.mailchimp.com/3.0/automations/workflow_id/emails")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://api.mailchimp.com/3.0/automations/workflow_id/emails")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.mailchimp.com/3.0/automations/workflow_id/emails', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
  ],
]);

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://api.mailchimp.com/3.0/automations/workflow_id/emails");
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Bearer <token>");
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = ["Authorization": "Bearer <token>"]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.mailchimp.com/3.0/automations/workflow_id/emails")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```

> Find all the Mailchimp API documentation and tools developers need to send marketing and transactional emails.