airbyte-agent-mailchimp 0.1.4__py3-none-any.whl

airbyte_agent_mailchimp/models.py

@@ -0,0 +1,956 @@
+"""
+Pydantic models for mailchimp connector.
+
+This module contains Pydantic models used for authentication configuration
+and response envelope types.
+"""
+
+from __future__ import annotations
+
+from pydantic import BaseModel, ConfigDict, Field
+from typing import TypeVar, Generic, Union, Any
+from typing import Optional
+
+# Authentication configuration
+
+class MailchimpAuthConfig(BaseModel):
+    """API Key Authentication"""
+
+    model_config = ConfigDict(extra="forbid")
+
+    api_key: str
+    """Your Mailchimp API key. You can find this in your Mailchimp account under Account > Extras > API keys."""
+    data_center: Optional[str] = None
+    """The data center for your Mailchimp account. This is the suffix of your API key (e.g., 'us6' if your API key ends with '-us6')."""
+
+# ===== RESPONSE TYPE DEFINITIONS (PYDANTIC) =====
+
+class CampaignRecipients(BaseModel):
+    """List settings for the campaign"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    list_id: Union[str | None, Any] = Field(default=None, description="The unique list id")
+    """The unique list id"""
+    list_is_active: Union[bool | None, Any] = Field(default=None, description="The status of the list used")
+    """The status of the list used"""
+    list_name: Union[str | None, Any] = Field(default=None, description="The name of the list")
+    """The name of the list"""
+    segment_text: Union[str | None, Any] = Field(default=None, description="A description of the segment used for the campaign")
+    """A description of the segment used for the campaign"""
+    recipient_count: Union[int | None, Any] = Field(default=None, description="Count of the recipients on the associated list")
+    """Count of the recipients on the associated list"""
+
+class CampaignTracking(BaseModel):
+    """The tracking options for a campaign"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    opens: Union[bool | None, Any] = Field(default=None, description="Whether to track opens")
+    """Whether to track opens"""
+    html_clicks: Union[bool | None, Any] = Field(default=None, description="Whether to track clicks in the HTML version of the campaign")
+    """Whether to track clicks in the HTML version of the campaign"""
+    text_clicks: Union[bool | None, Any] = Field(default=None, description="Whether to track clicks in the plain-text version of the campaign")
+    """Whether to track clicks in the plain-text version of the campaign"""
+    goal_tracking: Union[bool | None, Any] = Field(default=None, description="Whether to enable Goal tracking")
+    """Whether to enable Goal tracking"""
+    ecomm360: Union[bool | None, Any] = Field(default=None, description="Whether to enable eCommerce360 tracking")
+    """Whether to enable eCommerce360 tracking"""
+    google_analytics: Union[str | None, Any] = Field(default=None, description="The custom slug for Google Analytics tracking")
+    """The custom slug for Google Analytics tracking"""
+    clicktale: Union[str | None, Any] = Field(default=None, description="The custom slug for ClickTale tracking")
+    """The custom slug for ClickTale tracking"""
+
+class CampaignSettings(BaseModel):
+    """The settings for your campaign"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    subject_line: Union[str | None, Any] = Field(default=None, description="The subject line for the campaign")
+    """The subject line for the campaign"""
+    preview_text: Union[str | None, Any] = Field(default=None, description="The preview text for the campaign")
+    """The preview text for the campaign"""
+    title: Union[str | None, Any] = Field(default=None, description="The title of the campaign")
+    """The title of the campaign"""
+    from_name: Union[str | None, Any] = Field(default=None, description="The from name on the campaign")
+    """The from name on the campaign"""
+    reply_to: Union[str | None, Any] = Field(default=None, description="The reply-to email address for the campaign")
+    """The reply-to email address for the campaign"""
+    use_conversation: Union[bool | None, Any] = Field(default=None, description="Use Mailchimp Conversation feature to manage out-of-office replies")
+    """Use Mailchimp Conversation feature to manage out-of-office replies"""
+    to_name: Union[str | None, Any] = Field(default=None, description="The campaign's custom to name")
+    """The campaign's custom to name"""
+    folder_id: Union[str | None, Any] = Field(default=None, description="If the campaign is listed in a folder")
+    """If the campaign is listed in a folder"""
+    authenticate: Union[bool | None, Any] = Field(default=None, description="Whether Mailchimp authenticated the campaign")
+    """Whether Mailchimp authenticated the campaign"""
+    auto_footer: Union[bool | None, Any] = Field(default=None, description="Automatically append Mailchimp's default footer to the campaign")
+    """Automatically append Mailchimp's default footer to the campaign"""
+    inline_css: Union[bool | None, Any] = Field(default=None, description="Automatically inline the CSS included with the campaign content")
+    """Automatically inline the CSS included with the campaign content"""
+    auto_tweet: Union[bool | None, Any] = Field(default=None, description="Automatically tweet a link to the campaign archive page when the campaign is sent")
+    """Automatically tweet a link to the campaign archive page when the campaign is sent"""
+    fb_comments: Union[bool | None, Any] = Field(default=None, description="Allows Facebook comments on the campaign")
+    """Allows Facebook comments on the campaign"""
+    timewarp: Union[bool | None, Any] = Field(default=None, description="Send this campaign using Timewarp")
+    """Send this campaign using Timewarp"""
+    template_id: Union[int | None, Any] = Field(default=None, description="The id for the template used in this campaign")
+    """The id for the template used in this campaign"""
+    drag_and_drop: Union[bool | None, Any] = Field(default=None, description="Whether the campaign uses the drag-and-drop editor")
+    """Whether the campaign uses the drag-and-drop editor"""
+
+class CampaignDeliveryStatus(BaseModel):
+    """Updates on campaigns in the process of sending"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    enabled: Union[bool | None, Any] = Field(default=None, description="Whether Campaign Delivery Status is enabled for this account and target campaign")
+    """Whether Campaign Delivery Status is enabled for this account and target campaign"""
+    can_cancel: Union[bool | None, Any] = Field(default=None, description="Whether a campaign send can be canceled")
+    """Whether a campaign send can be canceled"""
+    status: Union[str | None, Any] = Field(default=None, description="The current state of a campaign delivery")
+    """The current state of a campaign delivery"""
+    emails_sent: Union[int | None, Any] = Field(default=None, description="The total number of emails confirmed sent for this campaign so far")
+    """The total number of emails confirmed sent for this campaign so far"""
+    emails_canceled: Union[int | None, Any] = Field(default=None, description="The total number of emails canceled for this campaign")
+    """The total number of emails canceled for this campaign"""
+
+class CampaignReportSummaryEcommerce(BaseModel):
+    """E-Commerce stats for a campaign"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    total_orders: Union[int | None, Any] = Field(default=None, description="The total orders for a campaign")
+    """The total orders for a campaign"""
+    total_spent: Union[float | None, Any] = Field(default=None, description="The total spent for a campaign")
+    """The total spent for a campaign"""
+    total_revenue: Union[float | None, Any] = Field(default=None, description="The total revenue for a campaign")
+    """The total revenue for a campaign"""
+
+class CampaignReportSummary(BaseModel):
+    """For sent campaigns, a summary of opens, clicks, and e-commerce data"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    opens: Union[int | None, Any] = Field(default=None, description="The total number of opens for a campaign")
+    """The total number of opens for a campaign"""
+    unique_opens: Union[int | None, Any] = Field(default=None, description="The number of unique opens")
+    """The number of unique opens"""
+    open_rate: Union[float | None, Any] = Field(default=None, description="The number of unique opens divided by the total number of successful deliveries")
+    """The number of unique opens divided by the total number of successful deliveries"""
+    clicks: Union[int | None, Any] = Field(default=None, description="The total number of clicks for an campaign")
+    """The total number of clicks for an campaign"""
+    subscriber_clicks: Union[int | None, Any] = Field(default=None, description="The number of unique clicks")
+    """The number of unique clicks"""
+    click_rate: Union[float | None, Any] = Field(default=None, description="The number of unique clicks divided by the total number of successful deliveries")
+    """The number of unique clicks divided by the total number of successful deliveries"""
+    ecommerce: Union[CampaignReportSummaryEcommerce | None, Any] = Field(default=None, description="E-Commerce stats for a campaign")
+    """E-Commerce stats for a campaign"""
+
+class Campaign(BaseModel):
+    """A summary of an individual campaign's settings and content"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    id: Union[str, Any] = Field(default=None)
+    web_id: Union[int | None, Any] = Field(default=None)
+    parent_campaign_id: Union[str | None, Any] = Field(default=None)
+    type: Union[str | None, Any] = Field(default=None)
+    create_time: Union[str | None, Any] = Field(default=None)
+    archive_url: Union[str | None, Any] = Field(default=None)
+    long_archive_url: Union[str | None, Any] = Field(default=None)
+    status: Union[str | None, Any] = Field(default=None)
+    emails_sent: Union[int | None, Any] = Field(default=None)
+    send_time: Union[str | None, Any] = Field(default=None)
+    content_type: Union[str | None, Any] = Field(default=None)
+    needs_block_refresh: Union[bool | None, Any] = Field(default=None)
+    resendable: Union[bool | None, Any] = Field(default=None)
+    recipients: Union[CampaignRecipients | None, Any] = Field(default=None)
+    settings: Union[CampaignSettings | None, Any] = Field(default=None)
+    tracking: Union[CampaignTracking | None, Any] = Field(default=None)
+    report_summary: Union[CampaignReportSummary | None, Any] = Field(default=None)
+    delivery_status: Union[CampaignDeliveryStatus | None, Any] = Field(default=None)
+
+class CampaignsList(BaseModel):
+    """A collection of campaigns"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    campaigns: Union[list[Campaign], Any] = Field(default=None)
+    total_items: Union[int, Any] = Field(default=None)
+
+class ListCampaignDefaults(BaseModel):
+    """Default values for campaigns created for this list"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    from_name: Union[str | None, Any] = Field(default=None, description="The default from name for campaigns sent to this list")
+    """The default from name for campaigns sent to this list"""
+    from_email: Union[str | None, Any] = Field(default=None, description="The default from email for campaigns sent to this list")
+    """The default from email for campaigns sent to this list"""
+    subject: Union[str | None, Any] = Field(default=None, description="The default subject line for campaigns sent to this list")
+    """The default subject line for campaigns sent to this list"""
+    language: Union[str | None, Any] = Field(default=None, description="The default language for this list's forms")
+    """The default language for this list's forms"""
+
+class ListContact(BaseModel):
+    """Contact information displayed in campaign footers to comply with international spam laws"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    company: Union[str | None, Any] = Field(default=None, description="The company name for the list")
+    """The company name for the list"""
+    address1: Union[str | None, Any] = Field(default=None, description="The street address for the list contact")
+    """The street address for the list contact"""
+    address2: Union[str | None, Any] = Field(default=None, description="The street address for the list contact")
+    """The street address for the list contact"""
+    city: Union[str | None, Any] = Field(default=None, description="The city for the list contact")
+    """The city for the list contact"""
+    state: Union[str | None, Any] = Field(default=None, description="The state for the list contact")
+    """The state for the list contact"""
+    zip: Union[str | None, Any] = Field(default=None, description="The postal or zip code for the list contact")
+    """The postal or zip code for the list contact"""
+    country: Union[str | None, Any] = Field(default=None, description="A two-character ISO3166 country code")
+    """A two-character ISO3166 country code"""
+    phone: Union[str | None, Any] = Field(default=None, description="The phone number for the list contact")
+    """The phone number for the list contact"""
+
+class ListStats(BaseModel):
+    """Stats for the list"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    member_count: Union[int | None, Any] = Field(default=None, description="The number of active members in the list")
+    """The number of active members in the list"""
+    total_contacts: Union[int | None, Any] = Field(default=None, description="The number of contacts in the list, including subscribed, unsubscribed, pending, cleaned, deleted, transactional, and those that need to be reconfirmed")
+    """The number of contacts in the list, including subscribed, unsubscribed, pending, cleaned, deleted, transactional, and those that need to be reconfirmed"""
+    unsubscribe_count: Union[int | None, Any] = Field(default=None, description="The number of members who have unsubscribed from the list")
+    """The number of members who have unsubscribed from the list"""
+    cleaned_count: Union[int | None, Any] = Field(default=None, description="The number of members cleaned from the list")
+    """The number of members cleaned from the list"""
+    member_count_since_send: Union[int | None, Any] = Field(default=None, description="The number of active members in the list since the last campaign was sent")
+    """The number of active members in the list since the last campaign was sent"""
+    unsubscribe_count_since_send: Union[int | None, Any] = Field(default=None, description="The number of members who have unsubscribed since the last campaign was sent")
+    """The number of members who have unsubscribed since the last campaign was sent"""
+    cleaned_count_since_send: Union[int | None, Any] = Field(default=None, description="The number of members cleaned from the list since the last campaign was sent")
+    """The number of members cleaned from the list since the last campaign was sent"""
+    campaign_count: Union[int | None, Any] = Field(default=None, description="The number of campaigns in any status that use this list")
+    """The number of campaigns in any status that use this list"""
+    campaign_last_sent: Union[str | None, Any] = Field(default=None, description="The date and time the last campaign was sent to this list")
+    """The date and time the last campaign was sent to this list"""
+    merge_field_count: Union[int | None, Any] = Field(default=None, description="The number of merge fields for this list")
+    """The number of merge fields for this list"""
+    avg_sub_rate: Union[float | None, Any] = Field(default=None, description="The average number of subscriptions per month for the list")
+    """The average number of subscriptions per month for the list"""
+    avg_unsub_rate: Union[float | None, Any] = Field(default=None, description="The average number of unsubscriptions per month for the list")
+    """The average number of unsubscriptions per month for the list"""
+    target_sub_rate: Union[float | None, Any] = Field(default=None, description="The target number of subscriptions per month for the list to keep it growing")
+    """The target number of subscriptions per month for the list to keep it growing"""
+    open_rate: Union[float | None, Any] = Field(default=None, description="The average open rate for campaigns sent to this list")
+    """The average open rate for campaigns sent to this list"""
+    click_rate: Union[float | None, Any] = Field(default=None, description="The average click rate for campaigns sent to this list")
+    """The average click rate for campaigns sent to this list"""
+    last_sub_date: Union[str | None, Any] = Field(default=None, description="The date and time of the last time someone subscribed to this list")
+    """The date and time of the last time someone subscribed to this list"""
+    last_unsub_date: Union[str | None, Any] = Field(default=None, description="The date and time of the last time someone unsubscribed from this list")
+    """The date and time of the last time someone unsubscribed from this list"""
+
+class List(BaseModel):
+    """Information about a specific list"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    id: Union[str, Any] = Field(default=None)
+    web_id: Union[int | None, Any] = Field(default=None)
+    name: Union[str | None, Any] = Field(default=None)
+    contact: Union[ListContact | None, Any] = Field(default=None)
+    permission_reminder: Union[str | None, Any] = Field(default=None)
+    use_archive_bar: Union[bool | None, Any] = Field(default=None)
+    campaign_defaults: Union[ListCampaignDefaults | None, Any] = Field(default=None)
+    notify_on_subscribe: Union[str | None, Any] = Field(default=None)
+    notify_on_unsubscribe: Union[str | None, Any] = Field(default=None)
+    date_created: Union[str | None, Any] = Field(default=None)
+    list_rating: Union[int | None, Any] = Field(default=None)
+    email_type_option: Union[bool | None, Any] = Field(default=None)
+    subscribe_url_short: Union[str | None, Any] = Field(default=None)
+    subscribe_url_long: Union[str | None, Any] = Field(default=None)
+    beamer_address: Union[str | None, Any] = Field(default=None)
+    visibility: Union[str | None, Any] = Field(default=None)
+    double_optin: Union[bool | None, Any] = Field(default=None)
+    has_welcome: Union[bool | None, Any] = Field(default=None)
+    marketing_permissions: Union[bool | None, Any] = Field(default=None)
+    stats: Union[ListStats | None, Any] = Field(default=None)
+
+class ListsList(BaseModel):
+    """A collection of subscriber lists for this account"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    lists: Union[list[List], Any] = Field(default=None)
+    total_items: Union[int, Any] = Field(default=None)
+
+class ListMemberStatsEcommerceData(BaseModel):
+    """Ecommerce stats for the list member if the list is attached to a store"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    total_revenue: Union[float | None, Any] = Field(default=None, description="The total revenue the list member has brought in")
+    """The total revenue the list member has brought in"""
+    number_of_orders: Union[float | None, Any] = Field(default=None, description="The total number of orders placed by the list member")
+    """The total number of orders placed by the list member"""
+    currency_code: Union[str | None, Any] = Field(default=None, description="The three-letter ISO 4217 code for the currency that the store accepts")
+    """The three-letter ISO 4217 code for the currency that the store accepts"""
+
+class ListMemberStats(BaseModel):
+    """Open and click rates for this subscriber"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    avg_open_rate: Union[float | None, Any] = Field(default=None, description="A subscriber's average open rate")
+    """A subscriber's average open rate"""
+    avg_click_rate: Union[float | None, Any] = Field(default=None, description="A subscriber's average clickthrough rate")
+    """A subscriber's average clickthrough rate"""
+    ecommerce_data: Union[ListMemberStatsEcommerceData | None, Any] = Field(default=None, description="Ecommerce stats for the list member if the list is attached to a store")
+    """Ecommerce stats for the list member if the list is attached to a store"""
+
+class ListMemberLocation(BaseModel):
+    """Subscriber location information"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    latitude: Union[float | None, Any] = Field(default=None, description="The location latitude")
+    """The location latitude"""
+    longitude: Union[float | None, Any] = Field(default=None, description="The location longitude")
+    """The location longitude"""
+    gmtoff: Union[int | None, Any] = Field(default=None, description="The time difference in hours from GMT")
+    """The time difference in hours from GMT"""
+    dstoff: Union[int | None, Any] = Field(default=None, description="The offset for timezones where daylight saving time is observed")
+    """The offset for timezones where daylight saving time is observed"""
+    country_code: Union[str | None, Any] = Field(default=None, description="The unique code for the location country")
+    """The unique code for the location country"""
+    timezone: Union[str | None, Any] = Field(default=None, description="The timezone for the location")
+    """The timezone for the location"""
+    region: Union[str | None, Any] = Field(default=None, description="The region for the location")
+    """The region for the location"""
+
+class ListMemberTagsItem(BaseModel):
+    """Nested schema for ListMember.tags_item"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    id: Union[int | None, Any] = Field(default=None, description="The tag id")
+    """The tag id"""
+    name: Union[str | None, Any] = Field(default=None, description="The name of the tag")
+    """The name of the tag"""
+
+class ListMember(BaseModel):
+    """Individuals who are currently or have been previously subscribed to this list"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    id: Union[str, Any] = Field(default=None)
+    email_address: Union[str | None, Any] = Field(default=None)
+    unique_email_id: Union[str | None, Any] = Field(default=None)
+    contact_id: Union[str | None, Any] = Field(default=None)
+    full_name: Union[str | None, Any] = Field(default=None)
+    web_id: Union[int | None, Any] = Field(default=None)
+    email_type: Union[str | None, Any] = Field(default=None)
+    status: Union[str | None, Any] = Field(default=None)
+    unsubscribe_reason: Union[str | None, Any] = Field(default=None)
+    consents_to_one_to_one_messaging: Union[bool | None, Any] = Field(default=None)
+    merge_fields: Union[dict[str, Any] | None, Any] = Field(default=None)
+    interests: Union[dict[str, bool] | None, Any] = Field(default=None)
+    stats: Union[ListMemberStats | None, Any] = Field(default=None)
+    ip_signup: Union[str | None, Any] = Field(default=None)
+    timestamp_signup: Union[str | None, Any] = Field(default=None)
+    ip_opt: Union[str | None, Any] = Field(default=None)
+    timestamp_opt: Union[str | None, Any] = Field(default=None)
+    member_rating: Union[int | None, Any] = Field(default=None)
+    last_changed: Union[str | None, Any] = Field(default=None)
+    language: Union[str | None, Any] = Field(default=None)
+    vip: Union[bool | None, Any] = Field(default=None)
+    email_client: Union[str | None, Any] = Field(default=None)
+    location: Union[ListMemberLocation | None, Any] = Field(default=None)
+    source: Union[str | None, Any] = Field(default=None)
+    tags_count: Union[int | None, Any] = Field(default=None)
+    tags: Union[list[ListMemberTagsItem] | None, Any] = Field(default=None)
+    list_id: Union[str | None, Any] = Field(default=None)
+
+class ListMembersList(BaseModel):
+    """Manage members of a specific Mailchimp list"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    members: Union[list[ListMember], Any] = Field(default=None)
+    list_id: Union[str | None, Any] = Field(default=None)
+    total_items: Union[int, Any] = Field(default=None)
+
+class ReportListStats(BaseModel):
+    """The average campaign statistics for your list"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    sub_rate: Union[float | None, Any] = Field(default=None, description="The average number of subscriptions per month for the list")
+    """The average number of subscriptions per month for the list"""
+    unsub_rate: Union[float | None, Any] = Field(default=None, description="The average number of unsubscriptions per month for the list")
+    """The average number of unsubscriptions per month for the list"""
+    open_rate: Union[float | None, Any] = Field(default=None, description="The average open rate for campaigns sent to this list")
+    """The average open rate for campaigns sent to this list"""
+    click_rate: Union[float | None, Any] = Field(default=None, description="The average click rate for campaigns sent to this list")
+    """The average click rate for campaigns sent to this list"""
+
+class ReportEcommerce(BaseModel):
+    """E-Commerce stats for a campaign"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    total_orders: Union[int | None, Any] = Field(default=None, description="The total orders for a campaign")
+    """The total orders for a campaign"""
+    total_spent: Union[float | None, Any] = Field(default=None, description="The total spent for a campaign")
+    """The total spent for a campaign"""
+    total_revenue: Union[float | None, Any] = Field(default=None, description="The total revenue for a campaign")
+    """The total revenue for a campaign"""
+
+class ReportFacebookLikes(BaseModel):
+    """An object describing campaign engagement on Facebook"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    recipient_likes: Union[int | None, Any] = Field(default=None, description="The number of recipients who liked the campaign on Facebook")
+    """The number of recipients who liked the campaign on Facebook"""
+    unique_likes: Union[int | None, Any] = Field(default=None, description="The number of unique likes")
+    """The number of unique likes"""
+    facebook_likes: Union[int | None, Any] = Field(default=None, description="The number of Facebook likes for the campaign")
+    """The number of Facebook likes for the campaign"""
+
+class ReportIndustryStats(BaseModel):
+    """The average campaign statistics for your industry"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    type: Union[str | None, Any] = Field(default=None, description="The type of business industry associated with your account")
+    """The type of business industry associated with your account"""
+    open_rate: Union[float | None, Any] = Field(default=None, description="The industry open rate")
+    """The industry open rate"""
+    click_rate: Union[float | None, Any] = Field(default=None, description="The industry click rate")
+    """The industry click rate"""
+    bounce_rate: Union[float | None, Any] = Field(default=None, description="The industry bounce rate")
+    """The industry bounce rate"""
+    unopen_rate: Union[float | None, Any] = Field(default=None, description="The industry unopened rate")
+    """The industry unopened rate"""
+    unsub_rate: Union[float | None, Any] = Field(default=None, description="The industry unsubscribe rate")
+    """The industry unsubscribe rate"""
+    abuse_rate: Union[float | None, Any] = Field(default=None, description="The industry abuse rate")
+    """The industry abuse rate"""
+
+class ReportOpens(BaseModel):
+    """An object describing the open activity for the campaign"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    opens_total: Union[int | None, Any] = Field(default=None, description="The total number of opens for a campaign")
+    """The total number of opens for a campaign"""
+    unique_opens: Union[int | None, Any] = Field(default=None, description="The total number of unique opens")
+    """The total number of unique opens"""
+    open_rate: Union[float | None, Any] = Field(default=None, description="The number of unique opens divided by the total number of successful deliveries")
+    """The number of unique opens divided by the total number of successful deliveries"""
+    last_open: Union[str | None, Any] = Field(default=None, description="The date and time of the last recorded open")
+    """The date and time of the last recorded open"""
+
+class ReportBounces(BaseModel):
+    """An object describing the bounce summary for the campaign"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    hard_bounces: Union[int | None, Any] = Field(default=None, description="The total number of hard bounced email addresses")
+    """The total number of hard bounced email addresses"""
+    soft_bounces: Union[int | None, Any] = Field(default=None, description="The total number of soft bounced email addresses")
+    """The total number of soft bounced email addresses"""
+    syntax_errors: Union[int | None, Any] = Field(default=None, description="The total number of addresses that were syntax-related bounces")
+    """The total number of addresses that were syntax-related bounces"""
+
+class ReportDeliveryStatus(BaseModel):
+    """Updates on campaigns in the process of sending"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    enabled: Union[bool | None, Any] = Field(default=None, description="Whether Campaign Delivery Status is enabled for this account and target campaign")
+    """Whether Campaign Delivery Status is enabled for this account and target campaign"""
+
+class ReportForwards(BaseModel):
+    """An object describing the forwards and forward activity for the campaign"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    forwards_count: Union[int | None, Any] = Field(default=None, description="How many times the campaign has been forwarded")
+    """How many times the campaign has been forwarded"""
+    forwards_opens: Union[int | None, Any] = Field(default=None, description="How many times the forwarded campaign has been opened")
+    """How many times the forwarded campaign has been opened"""
+
+class ReportClicks(BaseModel):
+    """An object describing the click activity for the campaign"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    clicks_total: Union[int | None, Any] = Field(default=None, description="The total number of clicks for the campaign")
+    """The total number of clicks for the campaign"""
+    unique_clicks: Union[int | None, Any] = Field(default=None, description="The total number of unique clicks for links across a campaign")
+    """The total number of unique clicks for links across a campaign"""
+    unique_subscriber_clicks: Union[int | None, Any] = Field(default=None, description="The total number of subscribers who clicked on a campaign")
+    """The total number of subscribers who clicked on a campaign"""
+    click_rate: Union[float | None, Any] = Field(default=None, description="The number of unique clicks divided by the total number of successful deliveries")
+    """The number of unique clicks divided by the total number of successful deliveries"""
+    last_click: Union[str | None, Any] = Field(default=None, description="The date and time of the last recorded click for the campaign")
+    """The date and time of the last recorded click for the campaign"""
+
+class Report(BaseModel):
+    """Report details about a sent campaign"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    id: Union[str, Any] = Field(default=None)
+    campaign_title: Union[str | None, Any] = Field(default=None)
+    type: Union[str | None, Any] = Field(default=None)
+    list_id: Union[str | None, Any] = Field(default=None)
+    list_is_active: Union[bool | None, Any] = Field(default=None)
+    list_name: Union[str | None, Any] = Field(default=None)
+    subject_line: Union[str | None, Any] = Field(default=None)
+    preview_text: Union[str | None, Any] = Field(default=None)
+    emails_sent: Union[int | None, Any] = Field(default=None)
+    abuse_reports: Union[int | None, Any] = Field(default=None)
+    unsubscribed: Union[int | None, Any] = Field(default=None)
+    send_time: Union[str | None, Any] = Field(default=None)
+    rss_last_send: Union[str | None, Any] = Field(default=None)
+    bounces: Union[ReportBounces | None, Any] = Field(default=None)
+    forwards: Union[ReportForwards | None, Any] = Field(default=None)
+    opens: Union[ReportOpens | None, Any] = Field(default=None)
+    clicks: Union[ReportClicks | None, Any] = Field(default=None)
+    facebook_likes: Union[ReportFacebookLikes | None, Any] = Field(default=None)
+    industry_stats: Union[ReportIndustryStats | None, Any] = Field(default=None)
+    list_stats: Union[ReportListStats | None, Any] = Field(default=None)
+    ecommerce: Union[ReportEcommerce | None, Any] = Field(default=None)
+    delivery_status: Union[ReportDeliveryStatus | None, Any] = Field(default=None)
+
+class ReportsList(BaseModel):
+    """A list of reports containing campaigns marked as Sent"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    reports: Union[list[Report], Any] = Field(default=None)
+    total_items: Union[int, Any] = Field(default=None)
+
+class EmailActivityActivityItem(BaseModel):
+    """Nested schema for EmailActivity.activity_item"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    action: Union[str | None, Any] = Field(default=None, description="One of the following actions open, click, or bounce")
+    """One of the following actions open, click, or bounce"""
+    timestamp: Union[str | None, Any] = Field(default=None, description="The date and time recorded for the action")
+    """The date and time recorded for the action"""
+    url: Union[str | None, Any] = Field(default=None, description="If the action is a click, the URL on which the member clicked")
+    """If the action is a click, the URL on which the member clicked"""
+    type: Union[str | None, Any] = Field(default=None, description="If the action is a bounce, the type of bounce received hard, soft, or blocked")
+    """If the action is a bounce, the type of bounce received hard, soft, or blocked"""
+    ip: Union[str | None, Any] = Field(default=None, description="The IP address recorded for the action")
+    """The IP address recorded for the action"""
+
+class EmailActivity(BaseModel):
+    """A summary of the email activity for a campaign"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    campaign_id: Union[str | None, Any] = Field(default=None)
+    list_id: Union[str | None, Any] = Field(default=None)
+    list_is_active: Union[bool | None, Any] = Field(default=None)
+    email_id: Union[str | None, Any] = Field(default=None)
+    email_address: Union[str | None, Any] = Field(default=None)
+    activity: Union[list[EmailActivityActivityItem] | None, Any] = Field(default=None)
+
+class EmailActivityList(BaseModel):
+    """A list of member's subscriber activity in a specific campaign"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    emails: Union[list[EmailActivity], Any] = Field(default=None)
+    campaign_id: Union[str | None, Any] = Field(default=None)
+    total_items: Union[int, Any] = Field(default=None)
+
+class AutomationReportSummary(BaseModel):
+    """A summary of opens and clicks for sent campaigns"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    opens: Union[int | None, Any] = Field(default=None, description="The total number of opens for a campaign")
+    """The total number of opens for a campaign"""
+    unique_opens: Union[int | None, Any] = Field(default=None, description="The number of unique opens")
+    """The number of unique opens"""
+    open_rate: Union[float | None, Any] = Field(default=None, description="The number of unique opens divided by the total number of successful deliveries")
+    """The number of unique opens divided by the total number of successful deliveries"""
+    clicks: Union[int | None, Any] = Field(default=None, description="The total number of clicks for an campaign")
+    """The total number of clicks for an campaign"""
+    subscriber_clicks: Union[int | None, Any] = Field(default=None, description="The number of unique clicks")
+    """The number of unique clicks"""
+    click_rate: Union[float | None, Any] = Field(default=None, description="The number of unique clicks divided by the total number of successful deliveries")
+    """The number of unique clicks divided by the total number of successful deliveries"""
+
+class AutomationTracking(BaseModel):
+    """The tracking options for the Automation"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    opens: Union[bool | None, Any] = Field(default=None, description="Whether to track opens")
+    """Whether to track opens"""
+    html_clicks: Union[bool | None, Any] = Field(default=None, description="Whether to track clicks in the HTML version")
+    """Whether to track clicks in the HTML version"""
+    text_clicks: Union[bool | None, Any] = Field(default=None, description="Whether to track clicks in the plain-text version")
+    """Whether to track clicks in the plain-text version"""
+    goal_tracking: Union[bool | None, Any] = Field(default=None, description="Whether to enable Goal tracking")
+    """Whether to enable Goal tracking"""
+    ecomm360: Union[bool | None, Any] = Field(default=None, description="Whether to enable eCommerce360 tracking")
+    """Whether to enable eCommerce360 tracking"""
+    google_analytics: Union[str | None, Any] = Field(default=None, description="The custom slug for Google Analytics tracking")
+    """The custom slug for Google Analytics tracking"""
+    clicktale: Union[str | None, Any] = Field(default=None, description="The custom slug for ClickTale tracking")
+    """The custom slug for ClickTale tracking"""
+
+class AutomationRecipientsSegmentOpts(BaseModel):
+    """An object representing all segmentation options"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    saved_segment_id: Union[int | None, Any] = Field(default=None, description="The id for an existing saved segment")
+    """The id for an existing saved segment"""
+    match: Union[str | None, Any] = Field(default=None, description="Segment match type")
+    """Segment match type"""
+    conditions: Union[list[dict[str, Any]] | None, Any] = Field(default=None, description="Segment match conditions")
+    """Segment match conditions"""
+
+class AutomationRecipients(BaseModel):
+    """List settings for the Automation"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    list_id: Union[str | None, Any] = Field(default=None, description="The unique list id")
+    """The unique list id"""
+    list_is_active: Union[bool | None, Any] = Field(default=None, description="The status of the list used")
+    """The status of the list used"""
+    list_name: Union[str | None, Any] = Field(default=None, description="The name of the list")
+    """The name of the list"""
+    segment_opts: Union[AutomationRecipientsSegmentOpts | None, Any] = Field(default=None, description="An object representing all segmentation options")
+    """An object representing all segmentation options"""
+    store_id: Union[str | None, Any] = Field(default=None, description="The id of the store")
+    """The id of the store"""
+
+class AutomationSettings(BaseModel):
+    """The settings for the Automation workflow"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    title: Union[str | None, Any] = Field(default=None, description="The title of the Automation")
+    """The title of the Automation"""
+    from_name: Union[str | None, Any] = Field(default=None, description="The from name for the Automation")
+    """The from name for the Automation"""
+    reply_to: Union[str | None, Any] = Field(default=None, description="The reply-to email address for the Automation")
+    """The reply-to email address for the Automation"""
+    use_conversation: Union[bool | None, Any] = Field(default=None, description="Whether to use Mailchimp Conversation feature")
+    """Whether to use Mailchimp Conversation feature"""
+    to_name: Union[str | None, Any] = Field(default=None, description="The Automation's custom to name")
+    """The Automation's custom to name"""
+    authenticate: Union[bool | None, Any] = Field(default=None, description="Whether Mailchimp authenticated the Automation")
+    """Whether Mailchimp authenticated the Automation"""
+    auto_footer: Union[bool | None, Any] = Field(default=None, description="Whether to automatically append Mailchimp's default footer")
+    """Whether to automatically append Mailchimp's default footer"""
+    inline_css: Union[bool | None, Any] = Field(default=None, description="Whether to automatically inline the CSS")
+    """Whether to automatically inline the CSS"""
+
+class Automation(BaseModel):
+    """A summary of an individual Automation workflow's settings and content"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    id: Union[str, Any] = Field(default=None)
+    create_time: Union[str | None, Any] = Field(default=None)
+    start_time: Union[str | None, Any] = Field(default=None)
+    status: Union[str | None, Any] = Field(default=None)
+    emails_sent: Union[int | None, Any] = Field(default=None)
+    recipients: Union[AutomationRecipients | None, Any] = Field(default=None)
+    settings: Union[AutomationSettings | None, Any] = Field(default=None)
+    tracking: Union[AutomationTracking | None, Any] = Field(default=None)
+    report_summary: Union[AutomationReportSummary | None, Any] = Field(default=None)
+
+class AutomationsList(BaseModel):
+    """A summary of the Automations for an account"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    automations: Union[list[Automation], Any] = Field(default=None)
+    total_items: Union[int, Any] = Field(default=None)
+
+class Tag(BaseModel):
+    """A tag that can be assigned to a list member"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    id: Union[int, Any] = Field(default=None)
+    name: Union[str | None, Any] = Field(default=None)
+
+class TagsList(BaseModel):
+    """A list of tags assigned to a list"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    tags: Union[list[Tag], Any] = Field(default=None)
+    total_items: Union[int, Any] = Field(default=None)
+
+class InterestCategory(BaseModel):
+    """Interest categories organize interests, which are used to group subscribers based on their preferences"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    list_id: Union[str | None, Any] = Field(default=None)
+    id: Union[str, Any] = Field(default=None)
+    title: Union[str | None, Any] = Field(default=None)
+    display_order: Union[int | None, Any] = Field(default=None)
+    type: Union[str | None, Any] = Field(default=None)
+
+class InterestCategoriesList(BaseModel):
+    """Information about this list's interest categories"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    list_id: Union[str | None, Any] = Field(default=None)
+    categories: Union[list[InterestCategory], Any] = Field(default=None)
+    total_items: Union[int, Any] = Field(default=None)
+
+class Interest(BaseModel):
+    """Assign subscribers to interests to group them together"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    category_id: Union[str | None, Any] = Field(default=None)
+    list_id: Union[str | None, Any] = Field(default=None)
+    id: Union[str, Any] = Field(default=None)
+    name: Union[str | None, Any] = Field(default=None)
+    subscriber_count: Union[str | None, Any] = Field(default=None)
+    display_order: Union[int | None, Any] = Field(default=None)
+
+class InterestsList(BaseModel):
+    """A list of interests for a specific list"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    interests: Union[list[Interest], Any] = Field(default=None)
+    list_id: Union[str | None, Any] = Field(default=None)
+    category_id: Union[str | None, Any] = Field(default=None)
+    total_items: Union[int, Any] = Field(default=None)
+
+class SegmentOptions(BaseModel):
+    """The conditions of the segment"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    match: Union[str | None, Any] = Field(default=None, description="Match type")
+    """Match type"""
+    conditions: Union[list[dict[str, Any]] | None, Any] = Field(default=None, description="Segment match conditions")
+    """Segment match conditions"""
+
+class Segment(BaseModel):
+    """Information about a specific segment"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    id: Union[int, Any] = Field(default=None)
+    name: Union[str | None, Any] = Field(default=None)
+    member_count: Union[int | None, Any] = Field(default=None)
+    type: Union[str | None, Any] = Field(default=None)
+    created_at: Union[str | None, Any] = Field(default=None)
+    updated_at: Union[str | None, Any] = Field(default=None)
+    options: Union[SegmentOptions | None, Any] = Field(default=None)
+    list_id: Union[str | None, Any] = Field(default=None)
+
+class SegmentsList(BaseModel):
+    """A list of available segments"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    segments: Union[list[Segment], Any] = Field(default=None)
+    list_id: Union[str | None, Any] = Field(default=None)
+    total_items: Union[int, Any] = Field(default=None)
+
+class SegmentMemberStats(BaseModel):
+    """Open and click rates for this subscriber"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    avg_open_rate: Union[float | None, Any] = Field(default=None, description="A subscriber's average open rate")
+    """A subscriber's average open rate"""
+    avg_click_rate: Union[float | None, Any] = Field(default=None, description="A subscriber's average clickthrough rate")
+    """A subscriber's average clickthrough rate"""
+
+class SegmentMemberLocation(BaseModel):
+    """Subscriber location information"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    latitude: Union[float | None, Any] = Field(default=None, description="The location latitude")
+    """The location latitude"""
+    longitude: Union[float | None, Any] = Field(default=None, description="The location longitude")
+    """The location longitude"""
+    gmtoff: Union[int | None, Any] = Field(default=None, description="The time difference in hours from GMT")
+    """The time difference in hours from GMT"""
+    dstoff: Union[int | None, Any] = Field(default=None, description="The offset for timezones where daylight saving time is observed")
+    """The offset for timezones where daylight saving time is observed"""
+    country_code: Union[str | None, Any] = Field(default=None, description="The unique code for the location country")
+    """The unique code for the location country"""
+    timezone: Union[str | None, Any] = Field(default=None, description="The timezone for the location")
+    """The timezone for the location"""
+    region: Union[str | None, Any] = Field(default=None, description="The region for the location")
+    """The region for the location"""
+
+class SegmentMember(BaseModel):
+    """Individuals who are currently or have been previously subscribed to this list"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    id: Union[str, Any] = Field(default=None)
+    email_address: Union[str | None, Any] = Field(default=None)
+    unique_email_id: Union[str | None, Any] = Field(default=None)
+    email_type: Union[str | None, Any] = Field(default=None)
+    status: Union[str | None, Any] = Field(default=None)
+    merge_fields: Union[dict[str, Any] | None, Any] = Field(default=None)
+    interests: Union[dict[str, bool] | None, Any] = Field(default=None)
+    stats: Union[SegmentMemberStats | None, Any] = Field(default=None)
+    ip_signup: Union[str | None, Any] = Field(default=None)
+    timestamp_signup: Union[str | None, Any] = Field(default=None)
+    ip_opt: Union[str | None, Any] = Field(default=None)
+    timestamp_opt: Union[str | None, Any] = Field(default=None)
+    member_rating: Union[int | None, Any] = Field(default=None)
+    last_changed: Union[str | None, Any] = Field(default=None)
+    language: Union[str | None, Any] = Field(default=None)
+    vip: Union[bool | None, Any] = Field(default=None)
+    email_client: Union[str | None, Any] = Field(default=None)
+    location: Union[SegmentMemberLocation | None, Any] = Field(default=None)
+    list_id: Union[str | None, Any] = Field(default=None)
+
+class SegmentMembersList(BaseModel):
+    """View members in a specific list segment"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    members: Union[list[SegmentMember], Any] = Field(default=None)
+    total_items: Union[int, Any] = Field(default=None)
+
+class Unsubscribe(BaseModel):
+    """A member who unsubscribed from a specific campaign"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    email_id: Union[str | None, Any] = Field(default=None)
+    email_address: Union[str | None, Any] = Field(default=None)
+    merge_fields: Union[dict[str, Any] | None, Any] = Field(default=None)
+    vip: Union[bool | None, Any] = Field(default=None)
+    timestamp: Union[str | None, Any] = Field(default=None)
+    reason: Union[str | None, Any] = Field(default=None)
+    campaign_id: Union[str | None, Any] = Field(default=None)
+    list_id: Union[str | None, Any] = Field(default=None)
+    list_is_active: Union[bool | None, Any] = Field(default=None)
+
+class UnsubscribesList(BaseModel):
+    """A list of members who have unsubscribed from a specific campaign"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    unsubscribes: Union[list[Unsubscribe], Any] = Field(default=None)
+    campaign_id: Union[str | None, Any] = Field(default=None)
+    total_items: Union[int, Any] = Field(default=None)
+
+# ===== METADATA TYPE DEFINITIONS (PYDANTIC) =====
+# Meta types for operations that extract metadata (e.g., pagination info)
+
+class CampaignsListResultMeta(BaseModel):
+    """Metadata for campaigns.Action.LIST operation"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    total_items: Union[int, Any] = Field(default=None)
+
+class ListsListResultMeta(BaseModel):
+    """Metadata for lists.Action.LIST operation"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    total_items: Union[int, Any] = Field(default=None)
+
+class ListMembersListResultMeta(BaseModel):
+    """Metadata for list_members.Action.LIST operation"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    total_items: Union[int, Any] = Field(default=None)
+
+class ReportsListResultMeta(BaseModel):
+    """Metadata for reports.Action.LIST operation"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    total_items: Union[int, Any] = Field(default=None)
+
+class EmailActivityListResultMeta(BaseModel):
+    """Metadata for email_activity.Action.LIST operation"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    total_items: Union[int, Any] = Field(default=None)
+
+class AutomationsListResultMeta(BaseModel):
+    """Metadata for automations.Action.LIST operation"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    total_items: Union[int, Any] = Field(default=None)
+
+class TagsListResultMeta(BaseModel):
+    """Metadata for tags.Action.LIST operation"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    total_items: Union[int, Any] = Field(default=None)
+
+class InterestCategoriesListResultMeta(BaseModel):
+    """Metadata for interest_categories.Action.LIST operation"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    total_items: Union[int, Any] = Field(default=None)
+
+class InterestsListResultMeta(BaseModel):
+    """Metadata for interests.Action.LIST operation"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    total_items: Union[int, Any] = Field(default=None)
+
+class SegmentsListResultMeta(BaseModel):
+    """Metadata for segments.Action.LIST operation"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    total_items: Union[int, Any] = Field(default=None)
+
+class SegmentMembersListResultMeta(BaseModel):
+    """Metadata for segment_members.Action.LIST operation"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    total_items: Union[int, Any] = Field(default=None)
+
+class UnsubscribesListResultMeta(BaseModel):
+    """Metadata for unsubscribes.Action.LIST operation"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    total_items: Union[int, Any] = Field(default=None)
+
+# ===== RESPONSE ENVELOPE MODELS =====
+
+# Type variables for generic envelope models
+T = TypeVar('T')
+S = TypeVar('S')
+
+
+class MailchimpExecuteResult(BaseModel, Generic[T]):
+    """Response envelope with data only.
+
+    Used for actions that return data without metadata.
+    """
+    model_config = ConfigDict(extra="forbid")
+
+    data: T
+    """Response data containing the result of the action."""
+
+
+class MailchimpExecuteResultWithMeta(MailchimpExecuteResult[T], Generic[T, S]):
+    """Response envelope with data and metadata.
+
+    Used for actions that return both data and metadata (e.g., pagination info).
+    """
+    meta: S
+    """Metadata about the response (e.g., pagination cursors, record counts)."""
+
+
+
+# ===== OPERATION RESULT TYPE ALIASES =====
+
+# Concrete type aliases for each operation result.
+# These provide simpler, more readable type annotations than using the generic forms.
+
+CampaignsListResult = MailchimpExecuteResultWithMeta[list[Campaign], CampaignsListResultMeta]
+"""Result type for campaigns.list operation with data and metadata."""
+
+ListsListResult = MailchimpExecuteResultWithMeta[list[List], ListsListResultMeta]
+"""Result type for lists.list operation with data and metadata."""
+
+ListMembersListResult = MailchimpExecuteResultWithMeta[list[ListMember], ListMembersListResultMeta]
+"""Result type for list_members.list operation with data and metadata."""
+
+ReportsListResult = MailchimpExecuteResultWithMeta[list[Report], ReportsListResultMeta]
+"""Result type for reports.list operation with data and metadata."""
+
+EmailActivityListResult = MailchimpExecuteResultWithMeta[list[EmailActivity], EmailActivityListResultMeta]
+"""Result type for email_activity.list operation with data and metadata."""
+
+AutomationsListResult = MailchimpExecuteResultWithMeta[list[Automation], AutomationsListResultMeta]
+"""Result type for automations.list operation with data and metadata."""
+
+TagsListResult = MailchimpExecuteResultWithMeta[list[Tag], TagsListResultMeta]
+"""Result type for tags.list operation with data and metadata."""
+
+InterestCategoriesListResult = MailchimpExecuteResultWithMeta[list[InterestCategory], InterestCategoriesListResultMeta]
+"""Result type for interest_categories.list operation with data and metadata."""
+
+InterestsListResult = MailchimpExecuteResultWithMeta[list[Interest], InterestsListResultMeta]
+"""Result type for interests.list operation with data and metadata."""
+
+SegmentsListResult = MailchimpExecuteResultWithMeta[list[Segment], SegmentsListResultMeta]
+"""Result type for segments.list operation with data and metadata."""
+
+SegmentMembersListResult = MailchimpExecuteResultWithMeta[list[SegmentMember], SegmentMembersListResultMeta]
+"""Result type for segment_members.list operation with data and metadata."""
+
+UnsubscribesListResult = MailchimpExecuteResultWithMeta[list[Unsubscribe], UnsubscribesListResultMeta]
+"""Result type for unsubscribes.list operation with data and metadata."""
+