Mailchimp Marketing API — List_id

naftiko: 1.0.0-alpha2
info:
  label: Mailchimp Marketing API  — List_id
  description: 'Mailchimp Marketing API  — List_id. 67 operations. Lead operation: Mailchimp Get List Info. Self-contained
    Naftiko capability covering one Mailchimp business surface.'
  tags:
  - Mailchimp
  - List_id
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MAILCHIMP_API_KEY: MAILCHIMP_API_KEY
capability:
  consumes:
  - type: http
    namespace: marketing-list-id
    baseUri: https://server.api.mailchimp.com/3.0
    description: Mailchimp Marketing API  — List_id business capability. Self-contained, no shared references.
    resources:
    - name: lists-list_id
      path: /lists/{list_id}
      operations:
      - name: getlistsid
        method: GET
        description: Mailchimp Get List 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: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: include_total_contacts
          in: query
          type: boolean
          description: Return the total_contacts field in the stats response, which contains an approximate count of all contacts
            in any state.
      - name: patchlistsid
        method: PATCH
        description: Mailchimp Update Lists
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: body
          in: body
          type: object
          required: true
      - name: deletelistsid
        method: DELETE
        description: Mailchimp Delete List
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
      - name: postlistsid
        method: POST
        description: Mailchimp Batch Subscribe or Unsubscribe
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: skip_merge_validation
          in: query
          type: boolean
          description: If skip_merge_validation is true, member data will be accepted without merge field values, even if
            the merge field is usually required. This defaults to false.
        - name: skip_duplicate_check
          in: query
          type: boolean
          description: If skip_duplicate_check is true, we will ignore duplicates sent in the request when using the batch
            sub/unsub on the lists endpoint. The status of the first app
        - name: body
          in: body
          type: object
          required: true
    - 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: lists-list_id-activity
      path: /lists/{list_id}/activity
      operations:
      - name: getlistsidactivity
        method: GET
        description: Mailchimp List Recent Activity
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - 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: 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: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
    - name: lists-list_id-clients
      path: /lists/{list_id}/clients
      operations:
      - name: getlistsidclients
        method: GET
        description: Mailchimp List Top Email Clients
        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: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
    - name: lists-list_id-growth-history
      path: /lists/{list_id}/growth-history
      operations:
      - name: getlistsidgrowthhistory
        method: GET
        description: Mailchimp List Growth History Data
        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: sort_field
          in: query
          type: string
          description: Returns files sorted by the specified field.
        - name: sort_dir
          in: query
          type: string
          description: Determines the order direction for sorted results.
    - name: lists-list_id-growth-history-month
      path: /lists/{list_id}/growth-history/{month}
      operations:
      - name: getlistsidgrowthhistoryid
        method: GET
        description: Mailchimp Get Growth History by Month
        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: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: month
          in: path
          type: string
          description: A specific month of list growth history.
          required: true
    - name: lists-list_id-interest-categories
      path: /lists/{list_id}/interest-categories
      operations:
      - name: getlistsidinterestcategories
        method: GET
        description: Mailchimp List Interest Categories
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - 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: Restrict results a type of interest group
      - name: postlistsidinterestcategories
        method: POST
        description: Mailchimp Add Interest Category
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: body
          in: body
          type: object
          required: true
    - name: lists-list_id-interest-categories-interest_category_id
      path: /lists/{list_id}/interest-categories/{interest_category_id}
      operations:
      - name: getlistsidinterestcategoriesid
        method: GET
        description: Mailchimp Get Interest Category Info
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: interest_category_id
          in: path
          type: string
          description: The unique ID for the interest category.
          required: true
        - 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: patchlistsidinterestcategoriesid
        method: PATCH
        description: Mailchimp Update Interest Category
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: interest_category_id
          in: path
          type: string
          description: The unique ID for the interest category.
          required: true
        - name: body
          in: body
          type: object
          required: true
      - name: deletelistsidinterestcategoriesid
        method: DELETE
        description: Mailchimp Delete Interest Category
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: interest_category_id
          in: path
          type: string
          description: The unique ID for the interest category.
          required: true
    - name: lists-list_id-interest-categories-interest_category_id-interests
      path: /lists/{list_id}/interest-categories/{interest_category_id}/interests
      operations:
      - name: getlistsidinterestcategoriesidinterests
        method: GET
        description: Mailchimp List Interests in Category
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: interest_category_id
          in: path
          type: string
          description: The unique ID for the interest category.
          required: true
        - 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: postlistsidinterestcategoriesidinterests
        method: POST
        description: Mailchimp Add Interest in Category
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: interest_category_id
          in: path
          type: string
          description: The unique ID for the interest category.
          required: true
        - name: body
          in: body
          type: object
          required: true
    - name: lists-list_id-interest-categories-interest_category_id-interests-interest_id
      path: /lists/{list_id}/interest-categories/{interest_category_id}/interests/{interest_id}
      operations:
      - name: getlistsidinterestcategoriesidinterestsid
        method: GET
        description: Mailchimp Get Interest in Category
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: interest_category_id
          in: path
          type: string
          description: The unique ID for the interest category.
          required: true
        - name: interest_id
          in: path
          type: string
          description: The specific interest or 'group name'.
          required: true
        - 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: patchlistsidinterestcategoriesidinterestsid
        method: PATCH
        description: Mailchimp Update Interest in Category
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: interest_category_id
          in: path
          type: string
          description: The unique ID for the interest category.
          required: true
        - name: interest_id
          in: path
          type: string
          description: The specific interest or 'group name'.
          required: true
        - name: body
          in: body
          type: object
          required: true
      - name: deletelistsidinterestcategoriesidinterestsid
        method: DELETE
        description: Mailchimp Delete Interest in Category
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: interest_category_id
          in: path
          type: string
          description: The unique ID for the interest category.
          required: true
        - name: interest_id
          in: path
          type: string
          description: The specific interest or 'group name'.
          required: true
    - name: lists-list_id-locations
      path: /lists/{list_id}/locations
      operations:
      - name: getlistsidlocations
        method: GET
        description: Mailchimp List Locations
        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: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
    - name: lists-list_id-members
      path: /lists/{list_id}/members
      operations:
      - name: getlistsidmembers
        method: GET
        description: Mailchimp List Members 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: 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: email_type
          in: query
          type: string
          description: The email type.
        - name: status
          in: query
          type: string
          description: The subscriber's status.
        - name: since_timestamp_opt
          in: query
          type: string
          description: 'Restrict results to subscribers who opted-in after the set timeframe. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.'
        - name: before_timestamp_opt
          in: query
          type: string
          description: 'Restrict results to subscribers who opted-in before the set timeframe. Uses ISO 8601 time format:
            2015-10-21T15:41:36+00:00.'
        - name: since_last_changed
          in: query
          type: string
          description: 'Restrict results to subscribers whose information changed after the set timeframe. Uses ISO 8601 time
            format: 2015-10-21T15:41:36+00:00.'
        - name: before_last_changed
          in: query
          type: string
          description: 'Restrict results to subscribers whose information changed before the set timeframe. Uses ISO 8601
            time format: 2015-10-21T15:41:36+00:00.'
        - name: unique_email_id
          in: query
          type: string
          description: A unique identifier for the email address across all Mailchimp lists.
        - name: vip_only
          in: query
          type: boolean
          description: A filter to return only the list's VIP members. Passing `true` will restrict results to VIP list members,
            passing `false` will return all list members.
        - name: interest_category_id
          in: query
          type: string
          description: The unique id for the interest category.
        - name: interest_ids
          in: query
          type: string
          description: Used to filter list members by interests. Must be accompanied by interest_category_id and interest_match.
            The value must be a comma separated list of interest i
        - name: interest_match
          in: query
          type: string
          description: Used to filter list members by interests. Must be accompanied by interest_category_id and interest_ids.
            "any" will match a member with any of the interest suppl
        - name: sort_field
          in: query
          type: string
          description: Returns files sorted by the specified field.
        - name: sort_dir
          in: query
          type: string
          description: Determines the order direction for sorted results.
        - name: since_last_campaign
          in: query
          type: boolean
          description: Filter subscribers by those subscribed/unsubscribed/pending/cleaned since last email campaign send.
            Member status is required to use this filter.
        - name: unsubscribed_since
          in: query
          type: string
          description: Filter subscribers by those unsubscribed since a specific date. Using any status other than unsubscribed
            with this filter will result in an error.
      - name: postlistsidmembers
        method: POST
        description: Mailchimp Add Member to List
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: skip_merge_validation
          in: query
          type: boolean
          description: If skip_merge_validation is true, member data will be accepted without merge field values, even if
            the merge field is usually required. This defaults to false.
        - name: body
          in: body
          type: object
          required: true
    - name: lists-list_id-members-subscriber_hash
      path: /lists/{list_id}/members/{subscriber_hash}
      operations:
      - name: getlistsidmembersid
        method: GET
        description: Mailchimp Get Member 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: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: subscriber_hash
          in: path
          type: string
          description: The MD5 hash of the lowercase version of the list member's email address. This endpoint also accepts
            a list member's email address or contact_id.
          required: true
      - name: putlistsidmembersid
        method: PUT
        description: Mailchimp Add or Update List Member
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: subscriber_hash
          in: path
          type: string
          description: The MD5 hash of the lowercase version of the list member's email address. This endpoint also accepts
            a list member's email address or contact_id.
          required: true
        - name: skip_merge_validation
          in: query
          type: boolean
          description: If skip_merge_validation is true, member data will be accepted without merge field values, even if
            the merge field is usually required. This defaults to false.
        - name: body
          in: body
          type: object
          required: true
      - name: patchlistsidmembersid
        method: PATCH
        description: Mailchimp Update List Member
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: subscriber_hash
          in: path
          type: string
          description: The MD5 hash of the lowercase version of the list member's email address. This endpoint also accepts
            a list member's email address or contact_id.
          required: true
        - name: skip_merge_validation
          in: query
          type: boolean
          description: If skip_merge_validation is true, member data will be accepted without merge field values, even if
            the merge field is usually required. This defaults to false.
        - name: body
          in: body
          type: object
          required: true
      - name: deletelistsidmembersid
        method: DELETE
        description: Mailchimp Archive List Member
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: subscriber_hash
          in: path
          type: string
          description: The MD5 hash of the lowercase version of the list member's email address. This endpoint also accepts
            a list member's email address or contact_id.
          required: true
    - name: lists-list_id-members-subscriber_hash-actions-delete-permanent
      path: /lists/{list_id}/members/{subscriber_hash}/actions/delete-permanent
      operations:
      - name: postlistsidmembershashactionsdeletepermanent
        method: POST
        description: Mailchimp Delete List Member
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          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: lists-list_id-members-subscriber_hash-activity
      path: /lists/{list_id}/members/{subscriber_hash}/activity
      operations:
      - name: getlistsidmembersidactivity
        method: GET
        description: Mailchimp View Recent Activity 50
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: subscriber_hash
          in: path
          type: string
          description: The MD5 hash of the lowercase version of the list member's email address. This endpoint also accepts
            a list member's email address or contact_id.
          required: true
        - 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: action
          in: query
          ty

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