Mailchimp Marketing API — Reports

naftiko: 1.0.0-alpha2
info:
  label: Mailchimp Marketing API  — Reports
  description: 'Mailchimp Marketing API  — Reports. 24 operations. Lead operation: Mailchimp List Abuse Reports. Self-contained
    Naftiko capability covering one Mailchimp business surface.'
  tags:
  - Mailchimp
  - Reports
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MAILCHIMP_API_KEY: MAILCHIMP_API_KEY
capability:
  consumes:
  - type: http
    namespace: marketing-reports
    baseUri: https://server.api.mailchimp.com/3.0
    description: Mailchimp Marketing API  — Reports business capability. Self-contained, no shared references.
    resources:
    - name: lists-list_id-abuse-reports
      path: /lists/{list_id}/abuse-reports
      operations:
      - name: getlistsidabusereports
        method: GET
        description: Mailchimp List Abuse Reports
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fields
          in: query
          type: array
          description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
        - name: exclude_fields
          in: query
          type: array
          description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
        - name: count
          in: query
          type: integer
          description: The number of records to return. Default value is 10. Maximum value is 1000
        - name: offset
          in: query
          type: integer
          description: Used for [pagination](https://mailchimp.com/developer/marketing/docs/methods-parameters/#pagination),
            this it the number of records from a collection to skip. D
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
    - name: lists-list_id-abuse-reports-report_id
      path: /lists/{list_id}/abuse-reports/{report_id}
      operations:
      - name: getlistsidabusereportsid
        method: GET
        description: Mailchimp Get Abuse Report
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fields
          in: query
          type: array
          description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
        - name: exclude_fields
          in: query
          type: array
          description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
        - name: count
          in: query
          type: integer
          description: The number of records to return. Default value is 10. Maximum value is 1000
        - name: offset
          in: query
          type: integer
          description: Used for [pagination](https://mailchimp.com/developer/marketing/docs/methods-parameters/#pagination),
            this it the number of records from a collection to skip. D
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: report_id
          in: path
          type: string
          description: The id for the abuse report.
          required: true
    - name: reports
      path: /reports
      operations:
      - name: getreports
        method: GET
        description: Mailchimp List Campaign Reports
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fields
          in: query
          type: array
          description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
        - name: exclude_fields
          in: query
          type: array
          description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
        - name: count
          in: query
          type: integer
          description: The number of records to return. Default value is 10. Maximum value is 1000
        - name: offset
          in: query
          type: integer
          description: Used for [pagination](https://mailchimp.com/developer/marketing/docs/methods-parameters/#pagination),
            this it the number of records from a collection to skip. D
        - name: type
          in: query
          type: string
          description: The campaign type.
        - name: before_send_time
          in: query
          type: string
          description: 'Restrict the response to campaigns sent before the set time. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.'
        - name: since_send_time
          in: query
          type: string
          description: 'Restrict the response to campaigns sent after the set time. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.'
    - name: reports-campaign_id
      path: /reports/{campaign_id}
      operations:
      - name: getreportsid
        method: GET
        description: Mailchimp Get Campaign Report
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fields
          in: query
          type: array
          description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
        - name: exclude_fields
          in: query
          type: array
          description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
        - name: campaign_id
          in: path
          type: string
          description: The unique id for the campaign.
          required: true
    - name: reports-campaign_id-abuse-reports
      path: /reports/{campaign_id}/abuse-reports
      operations:
      - name: getreportsidabusereportsid
        method: GET
        description: Mailchimp List Abuse Reports
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fields
          in: query
          type: array
          description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
        - name: exclude_fields
          in: query
          type: array
          description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
        - name: campaign_id
          in: path
          type: string
          description: The unique id for the campaign.
          required: true
    - name: reports-campaign_id-abuse-reports-report_id
      path: /reports/{campaign_id}/abuse-reports/{report_id}
      operations:
      - name: getreportsidabusereportsidid
        method: GET
        description: Mailchimp Get Abuse Report
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fields
          in: query
          type: array
          description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
        - name: exclude_fields
          in: query
          type: array
          description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
        - name: campaign_id
          in: path
          type: string
          description: The unique id for the campaign.
          required: true
        - name: report_id
          in: path
          type: string
          description: The id for the abuse report.
          required: true
    - name: reports-campaign_id-advice
      path: /reports/{campaign_id}/advice
      operations:
      - name: getreportsidadvice
        method: GET
        description: Mailchimp List Campaign Feedback
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fields
          in: query
          type: array
          description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
        - name: exclude_fields
          in: query
          type: array
          description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
        - name: campaign_id
          in: path
          type: string
          description: The unique id for the campaign.
          required: true
    - name: reports-campaign_id-click-details
      path: /reports/{campaign_id}/click-details
      operations:
      - name: getreportsidclickdetails
        method: GET
        description: Mailchimp List Campaign Details
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fields
          in: query
          type: array
          description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
        - name: exclude_fields
          in: query
          type: array
          description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
        - name: count
          in: query
          type: integer
          description: The number of records to return. Default value is 10. Maximum value is 1000
        - name: offset
          in: query
          type: integer
          description: Used for [pagination](https://mailchimp.com/developer/marketing/docs/methods-parameters/#pagination),
            this it the number of records from a collection to skip. D
        - name: campaign_id
          in: path
          type: string
          description: The unique id for the campaign.
          required: true
        - name: sort_field
          in: query
          type: string
          description: Returns click reports sorted by the specified field.
        - name: sort_dir
          in: query
          type: string
          description: Determines the order direction for sorted results.
    - name: reports-campaign_id-click-details-link_id
      path: /reports/{campaign_id}/click-details/{link_id}
      operations:
      - name: getreportsidclickdetailsid
        method: GET
        description: Mailchimp Get Campaign Link Details
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fields
          in: query
          type: array
          description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
        - name: exclude_fields
          in: query
          type: array
          description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
        - name: campaign_id
          in: path
          type: string
          description: The unique id for the campaign.
          required: true
        - name: link_id
          in: path
          type: string
          description: The id for the link.
          required: true
    - name: reports-campaign_id-click-details-link_id-members
      path: /reports/{campaign_id}/click-details/{link_id}/members
      operations:
      - name: getreportsidclickdetailsidmembers
        method: GET
        description: Mailchimp List Clicked Link Subscribers
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fields
          in: query
          type: array
          description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
        - name: exclude_fields
          in: query
          type: array
          description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
        - name: count
          in: query
          type: integer
          description: The number of records to return. Default value is 10. Maximum value is 1000
        - name: offset
          in: query
          type: integer
          description: Used for [pagination](https://mailchimp.com/developer/marketing/docs/methods-parameters/#pagination),
            this it the number of records from a collection to skip. D
        - name: campaign_id
          in: path
          type: string
          description: The unique id for the campaign.
          required: true
        - name: link_id
          in: path
          type: string
          description: The id for the link.
          required: true
    - name: reports-campaign_id-click-details-link_id-members-subscriber_hash
      path: /reports/{campaign_id}/click-details/{link_id}/members/{subscriber_hash}
      operations:
      - name: getreportsidclickdetailsidmembersid
        method: GET
        description: Mailchimp Get Clicked Link Subscriber
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fields
          in: query
          type: array
          description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
        - name: exclude_fields
          in: query
          type: array
          description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
        - name: campaign_id
          in: path
          type: string
          description: The unique id for the campaign.
          required: true
        - name: link_id
          in: path
          type: string
          description: The id for the link.
          required: true
        - name: subscriber_hash
          in: path
          type: string
          description: The MD5 hash of the lowercase version of the list member's email address.
          required: true
    - name: reports-campaign_id-domain-performance
      path: /reports/{campaign_id}/domain-performance
      operations:
      - name: getreportsiddomainperformance
        method: GET
        description: Mailchimp List Domain Performance Stats
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fields
          in: query
          type: array
          description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
        - name: exclude_fields
          in: query
          type: array
          description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
        - name: campaign_id
          in: path
          type: string
          description: The unique id for the campaign.
          required: true
    - name: reports-campaign_id-ecommerce-product-activity
      path: /reports/{campaign_id}/ecommerce-product-activity
      operations:
      - name: getreportsidecommerceproductactivity
        method: GET
        description: Mailchimp List Campaign Product Activity
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fields
          in: query
          type: array
          description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
        - name: exclude_fields
          in: query
          type: array
          description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
        - name: count
          in: query
          type: integer
          description: The number of records to return. Default value is 10. Maximum value is 1000
        - name: offset
          in: query
          type: integer
          description: Used for [pagination](https://mailchimp.com/developer/marketing/docs/methods-parameters/#pagination),
            this it the number of records from a collection to skip. D
        - name: campaign_id
          in: path
          type: string
          description: The unique id for the campaign.
          required: true
        - name: sort_field
          in: query
          type: string
          description: Returns files sorted by the specified field.
    - name: reports-campaign_id-eepurl
      path: /reports/{campaign_id}/eepurl
      operations:
      - name: getreportsideepurl
        method: GET
        description: Mailchimp List Eepurl Activity
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fields
          in: query
          type: array
          description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
        - name: exclude_fields
          in: query
          type: array
          description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
        - name: campaign_id
          in: path
          type: string
          description: The unique id for the campaign.
          required: true
    - name: reports-campaign_id-email-activity
      path: /reports/{campaign_id}/email-activity
      operations:
      - name: getreportsidemailactivity
        method: GET
        description: Mailchimp List Email Activity
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fields
          in: query
          type: array
          description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
        - name: exclude_fields
          in: query
          type: array
          description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
        - name: count
          in: query
          type: integer
          description: The number of records to return. Default value is 10. Maximum value is 1000
        - name: offset
          in: query
          type: integer
          description: Used for [pagination](https://mailchimp.com/developer/marketing/docs/methods-parameters/#pagination),
            this it the number of records from a collection to skip. D
        - name: campaign_id
          in: path
          type: string
          description: The unique id for the campaign.
          required: true
        - name: since
          in: query
          type: string
          description: 'Restrict results to email activity events that occur after a specific time. Uses ISO 8601 time format:
            2015-10-21T15:41:36+00:00.'
    - name: reports-campaign_id-email-activity-subscriber_hash
      path: /reports/{campaign_id}/email-activity/{subscriber_hash}
      operations:
      - name: getreportsidemailactivityid
        method: GET
        description: Mailchimp Get Subscriber Email Activity
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fields
          in: query
          type: array
          description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
        - name: exclude_fields
          in: query
          type: array
          description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
        - name: campaign_id
          in: path
          type: string
          description: The unique id for the campaign.
          required: true
        - name: subscriber_hash
          in: path
          type: string
          description: The MD5 hash of the lowercase version of the list member's email address.
          required: true
        - name: since
          in: query
          type: string
          description: 'Restrict results to email activity events that occur after a specific time. Uses ISO 8601 time format:
            2015-10-21T15:41:36+00:00.'
    - name: reports-campaign_id-locations
      path: /reports/{campaign_id}/locations
      operations:
      - name: getreportsidlocations
        method: GET
        description: Mailchimp List Top Open Activities
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fields
          in: query
          type: array
          description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
        - name: exclude_fields
          in: query
          type: array
          description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
        - name: campaign_id
          in: path
          type: string
          description: The unique id for the campaign.
          required: true
        - name: count
          in: query
          type: integer
          description: The number of records to return. Default value is 10. Maximum value is 1000
        - name: offset
          in: query
          type: integer
          description: Used for [pagination](https://mailchimp.com/developer/marketing/docs/methods-parameters/#pagination),
            this it the number of records from a collection to skip. D
    - name: reports-campaign_id-open-details
      path: /reports/{campaign_id}/open-details
      operations:
      - name: getreportsidopendetails
        method: GET
        description: Mailchimp List Campaign Open Details
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fields
          in: query
          type: array
          description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
        - name: exclude_fields
          in: query
          type: array
          description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
        - name: count
          in: query
          type: integer
          description: The number of records to return. Default value is 10. Maximum value is 1000
        - name: offset
          in: query
          type: integer
          description: Used for [pagination](https://mailchimp.com/developer/marketing/docs/methods-parameters/#pagination),
            this it the number of records from a collection to skip. D
        - name: campaign_id
          in: path
          type: string
          description: The unique id for the campaign.
          required: true
        - name: since
          in: query
          type: string
          description: 'Restrict results to campaign open events that occur after a specific time. Uses ISO 8601 time format:
            2015-10-21T15:41:36+00:00.'
        - name: sort_field
          in: query
          type: string
          description: Returns open reports sorted by the specified field.
        - name: sort_dir
          in: query
          type: string
          description: Determines the order direction for sorted results.
    - name: reports-campaign_id-open-details-subscriber_hash
      path: /reports/{campaign_id}/open-details/{subscriber_hash}
      operations:
      - name: getreportsidopendetailsidmembersid
        method: GET
        description: Mailchimp Get Opened Campaign Subscriber
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fields
          in: query
          type: array
          description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
        - name: exclude_fields
          in: query
          type: array
          description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
        - name: campaign_id
          in: path
          type: string
          description: The unique id for the campaign.
          required: true
        - name: subscriber_hash
          in: path
          type: string
          description: The MD5 hash of the lowercase version of the list member's email address.
          required: true
    - name: reports-campaign_id-sent-to
      path: /reports/{campaign_id}/sent-to
      operations:
      - name: getreportsidsentto
        method: GET
        description: Mailchimp List Campaign Recipients
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fields
          in: query
          type: array
          description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
        - name: exclude_fields
          in: query
          type: array
          description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
        - name: count
          in: query
          type: integer
          description: The number of records to return. Default value is 10. Maximum value is 1000
        - name: offset
          in: query
          type: integer
          description: Used for [pagination](https://mailchimp.com/developer/marketing/docs/methods-parameters/#pagination),
            this it the number of records from a collection to skip. D
        - name: campaign_id
          in: path
          type: string
          description: The unique id for the campaign.
          required: true
    - name: reports-campaign_id-sent-to-subscriber_hash
      path: /reports/{campaign_id}/sent-to/{subscriber_hash}
      operations:
      - name: getreportsidsenttoid
        method: GET
        description: Mailchimp Get Campaign Recipient Info
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fields
          in: query
          type: array
          description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
        - name: exclude_fields
          in: query
          type: array
          description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
        - name: campaign_id
          in: path
          type: string
          description: The unique id for the campaign.
          required: true
        - name: subscriber_hash
          in: path
          type: string
          description: The MD5 hash of the lowercase version of the list member's email address.
          required: true
    - name: reports-campaign_id-sub-reports
      path: /reports/{campaign_id}/sub-reports
      operations:
      - name: getreportsidsubreportsid
        method: GET
        description: Mailchimp List Child Campaign Reports
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fields
          in: query
          type: array
          description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
        - name: exclude_fields
          in: query
          type: array
          description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
        - name: campaign_id
          in: path
          type: string
          description: The unique id for the campaign.
          required: true
    - name: reports-campaign_id-unsubscribed
      path: /reports/{campaign_id}/unsubscribed
      operations:
      - name: getreportsidunsubscribed
        method: GET
        description: Mailchimp List Unsubscribed Members
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fields
          in: query
          type: array
          description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
        - name: exclude_fields
          in: query
          type: array
          description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
        - name: count
          in: query
          type: integer
          description: The number of records to return. Default value is 10. Maximum value is 1000
        - name: offset
          in: query
          type: integer
          description: Used for [pagination](https://mailchimp.com/developer/marketing/docs/methods-parameters/#pagination),
            this it the number of records from a collection to skip. D
        - name: campaign_id
          in: path
          type: string
          description: The unique id for the campaign.
          required: true
    - name: reports-campaign_id-unsubscribed-subscriber_hash
      path: /reports/{campaign_id}/unsubscribed/{subscriber_hash}
      operations:
      - name: getreportsidunsubscribedid
        method: GET
        description: Mailchimp Get Unsubscribed Member
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fields
          in: query
          type: array
          description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
        - name: exclude_fields
          in: query
          type: array
          description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
        - name: campaign_id
          in: path
          type: string
          description: The unique id for the campaign.
          required: true
        - name: subscriber_hash
          in: path
          type: string
          description: The MD5 hash of the lowercase version of the list member's email address.
          required: true
  exposes:
  - type: rest
    namespace: marketing-reports-rest
    port: 8080
    description: REST adapter for Mailchimp Marketing API  — Reports. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/lists/{list-id}/abuse-reports
      name: lists-list-id-abuse-reports
      description: REST surface for lists-list_id-abuse-reports.
      operations:
      - method: GET
        name: getlistsidabusereports
        description: Mailchimp List Abuse Reports
        call: marketing-reports.getlistsidabusereports
        with:
          fields: rest.fields
          exclude_fields: rest.exclude_fields
          count: rest.count
          offset: rest.offset
          list_id: rest.list_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/lists/{list-id}/abuse-reports/{report-id}
      name: lists-list-id-abuse-reports-report-id
      description: REST surface for lists-list_id-abuse-reports-report_id.
      operations:
      - method: GET
        name: getlistsidabusereportsid
        description: Mailchimp Get Abuse Report
        call: marketing-reports.getlistsidabusereportsid
        with:
          fields: rest.fields
          exclude_fields: rest.exclude_fields
          count: rest.count
          offset: rest.offset
          list_id: rest.list_id
          report_id: rest.report_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reports
      name: reports
      description: REST surface for reports.
      operations:
      - method: GET
        name: getreports
        description: Mailchimp List Campaign Reports
        call: marketing-reports.getreports
        with:
          fields: rest.fields
          exclude_fields: rest.exclude_fields
          count: rest.count
          offset: rest.offset
          type: rest.type
          before_send_time: rest.before_send_time
          since_send_time: re

# --- truncated at 32 KB (56 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mailchimp/refs/heads/main/capabilities/marketing-reports.yaml