Mailchimp Tags API

openapi: 3.2.0
info:
  version: 1.4.1
  title: Mailchimp Transactional Tags API
  contact:
    name: API Support
    email: apihelp@mailchimp.com
  x-permalink: https://github.com/mailchimp/mailchimp-client-lib-codegen/blob/main/spec/transactional.openapi.json
servers:
- url: https://mandrillapp.com/api/1.3
tags:
- name: tags
paths:
  /tags/list:
    post:
      x-custom-config:
        methodNameCamel: list
        methodNameSnake: list
      summary: List tags
      description: Return all of the user-defined tag information.
      operationId: postTagsList
      tags:
      - tags
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                description: a list of user-defined tags
                items:
                  type: object
                  description: a user-defined tag
                  properties:
                    tag:
                      type: string
                      description: the actual tag as a string
                      example: my_tag
                    reputation:
                      type: integer
                      description: the tag's current reputation on a scale from 0 to 100.
                      minimum: 0
                      maximum: 100
                      example: 95
                    sent:
                      type: integer
                      description: the total number of messages sent with this tag
                      example: 1000
                    hard_bounces:
                      type: integer
                      description: the total number of hard bounces by messages with this tag
                      example: 50
                    soft_bounces:
                      type: integer
                      description: the total number of soft bounces by messages with this tag
                      example: 25
                    rejects:
                      type: integer
                      description: the total number of rejected messages with this tag
                      example: 10
                    complaints:
                      type: integer
                      description: the total number of spam complaints received for messages with this tag
                      example: 5
                    unsubs:
                      type: integer
                      description: the total number of unsubscribe requests received for messages with this tag
                      example: 2
                    opens:
                      type: integer
                      description: the total number of times messages with this tag have been opened
                      example: 5000
                    clicks:
                      type: integer
                      description: the total number of times tracked URLs in messages with this tag have been clicked
                      example: 1000
                    unique_opens:
                      type: integer
                      description: the number of unique opens for emails sent with this tag
                      example: 4500
                    unique_clicks:
                      type: integer
                      description: the number of unique clicks for emails sent with this tag
                      example: 900
            application/x-php:
              schema:
                type: array
                description: a list of user-defined tags
                items:
                  type: object
                  description: a user-defined tag
                  properties:
                    tag:
                      type: string
                      description: the actual tag as a string
                      example: my_tag
                    reputation:
                      type: integer
                      description: the tag's current reputation on a scale from 0 to 100.
                      minimum: 0
                      maximum: 100
                      example: 95
                    sent:
                      type: integer
                      description: the total number of messages sent with this tag
                      example: 1000
                    hard_bounces:
                      type: integer
                      description: the total number of hard bounces by messages with this tag
                      example: 50
                    soft_bounces:
                      type: integer
                      description: the total number of soft bounces by messages with this tag
                      example: 25
                    rejects:
                      type: integer
                      description: the total number of rejected messages with this tag
                      example: 10
                    complaints:
                      type: integer
                      description: the total number of spam complaints received for messages with this tag
                      example: 5
                    unsubs:
                      type: integer
                      description: the total number of unsubscribe requests received for messages with this tag
                      example: 2
                    opens:
                      type: integer
                      description: the total number of times messages with this tag have been opened
                      example: 5000
                    clicks:
                      type: integer
                      description: the total number of times tracked URLs in messages with this tag have been clicked
                      example: 1000
                    unique_opens:
                      type: integer
                      description: the number of unique opens for emails sent with this tag
                      example: 4500
                    unique_clicks:
                      type: integer
                      description: the number of unique clicks for emails sent with this tag
                      example: 900
            application/x-yaml; charset=utf-8:
              schema:
                type: array
                description: a list of user-defined tags
                items:
                  type: object
                  description: a user-defined tag
                  properties:
                    tag:
                      type: string
                      description: the actual tag as a string
                      example: my_tag
                    reputation:
                      type: integer
                      description: the tag's current reputation on a scale from 0 to 100.
                      minimum: 0
                      maximum: 100
                      example: 95
                    sent:
                      type: integer
                      description: the total number of messages sent with this tag
                      example: 1000
                    hard_bounces:
                      type: integer
                      description: the total number of hard bounces by messages with this tag
                      example: 50
                    soft_bounces:
                      type: integer
                      description: the total number of soft bounces by messages with this tag
                      example: 25
                    rejects:
                      type: integer
                      description: the total number of rejected messages with this tag
                      example: 10
                    complaints:
                      type: integer
                      description: the total number of spam complaints received for messages with this tag
                      example: 5
                    unsubs:
                      type: integer
                      description: the total number of unsubscribe requests received for messages with this tag
                      example: 2
                    opens:
                      type: integer
                      description: the total number of times messages with this tag have been opened
                      example: 5000
                    clicks:
                      type: integer
                      description: the total number of times tracked URLs in messages with this tag have been clicked
                      example: 1000
                    unique_opens:
                      type: integer
                      description: the number of unique opens for emails sent with this tag
                      example: 4500
                    unique_clicks:
                      type: integer
                      description: the number of unique clicks for emails sent with this tag
                      example: 900
      deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - key
              properties:
                key:
                  type: string
                  description: a valid api key
        required: true
  /tags/delete:
    post:
      x-custom-config:
        methodNameCamel: delete
        methodNameSnake: delete
      summary: Delete tag
      description: Deletes a tag permanently. Deleting a tag removes the tag from any messages that have been sent, and also deletes the tag's stats. There is no way to undo this operation, so use it carefully.
      operationId: postTagsDelete
      tags:
      - tags
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                description: the tag that was deleted
                properties:
                  tag:
                    type: string
                    description: the actual tag as a string
                    example: my_tag
                  reputation:
                    type: integer
                    description: the tag's current reputation on a scale from 0 to 100.
                    minimum: 0
                    maximum: 100
                    example: 95
                  sent:
                    type: integer
                    description: the total number of messages sent with this tag
                    example: 1000
                  hard_bounces:
                    type: integer
                    description: the total number of hard bounces by messages with this tag
                    example: 50
                  soft_bounces:
                    type: integer
                    description: the total number of soft bounces by messages with this tag
                    example: 25
                  rejects:
                    type: integer
                    description: the total number of rejected messages with this tag
                    example: 10
                  complaints:
                    type: integer
                    description: the total number of spam complaints received for messages with this tag
                    example: 5
                  unsubs:
                    type: integer
                    description: the total number of unsubscribe requests received for messages with this tag
                    example: 2
                  opens:
                    type: integer
                    description: the total number of times messages with this tag have been opened
                    example: 100
                  clicks:
                    type: integer
                    description: the total number of times tracked URLs in messages with this tag have been clicked
                    example: 50
                  unique_opens:
                    type: integer
                    description: the number of unique opens for emails sent with this tag
                    example: 75
                  unique_clicks:
                    type: integer
                    description: the number of unique clicks for emails sent with this tag
                    example: 30
            application/x-php:
              schema:
                type: object
                description: the tag that was deleted
                properties:
                  tag:
                    type: string
                    description: the actual tag as a string
                    example: my_tag
                  reputation:
                    type: integer
                    description: the tag's current reputation on a scale from 0 to 100.
                    minimum: 0
                    maximum: 100
                    example: 95
                  sent:
                    type: integer
                    description: the total number of messages sent with this tag
                    example: 1000
                  hard_bounces:
                    type: integer
                    description: the total number of hard bounces by messages with this tag
                    example: 50
                  soft_bounces:
                    type: integer
                    description: the total number of soft bounces by messages with this tag
                    example: 25
                  rejects:
                    type: integer
                    description: the total number of rejected messages with this tag
                    example: 10
                  complaints:
                    type: integer
                    description: the total number of spam complaints received for messages with this tag
                    example: 5
                  unsubs:
                    type: integer
                    description: the total number of unsubscribe requests received for messages with this tag
                    example: 2
                  opens:
                    type: integer
                    description: the total number of times messages with this tag have been opened
                    example: 100
                  clicks:
                    type: integer
                    description: the total number of times tracked URLs in messages with this tag have been clicked
                    example: 50
                  unique_opens:
                    type: integer
                    description: the number of unique opens for emails sent with this tag
                    example: 75
                  unique_clicks:
                    type: integer
                    description: the number of unique clicks for emails sent with this tag
                    example: 30
            application/x-yaml; charset=utf-8:
              schema:
                type: object
                description: the tag that was deleted
                properties:
                  tag:
                    type: string
                    description: the actual tag as a string
                    example: my_tag
                  reputation:
                    type: integer
                    description: the tag's current reputation on a scale from 0 to 100.
                    minimum: 0
                    maximum: 100
                    example: 95
                  sent:
                    type: integer
                    description: the total number of messages sent with this tag
                    example: 1000
                  hard_bounces:
                    type: integer
                    description: the total number of hard bounces by messages with this tag
                    example: 50
                  soft_bounces:
                    type: integer
                    description: the total number of soft bounces by messages with this tag
                    example: 25
                  rejects:
                    type: integer
                    description: the total number of rejected messages with this tag
                    example: 10
                  complaints:
                    type: integer
                    description: the total number of spam complaints received for messages with this tag
                    example: 5
                  unsubs:
                    type: integer
                    description: the total number of unsubscribe requests received for messages with this tag
                    example: 2
                  opens:
                    type: integer
                    description: the total number of times messages with this tag have been opened
                    example: 100
                  clicks:
                    type: integer
                    description: the total number of times tracked URLs in messages with this tag have been clicked
                    example: 50
                  unique_opens:
                    type: integer
                    description: the number of unique opens for emails sent with this tag
                    example: 75
                  unique_clicks:
                    type: integer
                    description: the number of unique clicks for emails sent with this tag
                    example: 30
      deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - key
              - tag
              properties:
                key:
                  type: string
                  description: a valid api key
                tag:
                  type: string
                  description: a tag name
        required: true
  /tags/info:
    post:
      x-custom-config:
        methodNameCamel: info
        methodNameSnake: info
      summary: Get tag info
      description: Return more detailed information about a single tag, including aggregates of recent stats.
      operationId: postTagsInfo
      tags:
      - tags
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                description: the detailed information on the tag
                properties:
                  tag:
                    type: string
                    description: the actual tag as a string
                    example: my_tag
                  sent:
                    type: integer
                    description: the total number of messages sent with this tag
                    example: 100
                  hard_bounces:
                    type: integer
                    description: the total number of hard bounces by messages with this tag
                    example: 5
                  soft_bounces:
                    type: integer
                    description: the total number of soft bounces by messages with this tag
                    example: 25
                  rejects:
                    type: integer
                    description: the total number of rejected messages with this tag
                    example: 10
                  complaints:
                    type: integer
                    description: the total number of spam complaints received for messages with this tag
                    example: 2
                  unsubs:
                    type: integer
                    description: the total number of unsubscribe requests received for messages with this tag
                    example: 1
                  opens:
                    type: integer
                    description: the total number of times messages with this tag have been opened
                    example: 50
                  clicks:
                    type: integer
                    description: the total number of times tracked URLs in messages with this tag have been clicked
                    example: 25
                  stats:
                    type: object
                    description: an aggregate summary of the tag's sending stats
                    properties:
                      today:
                        type: object
                        description: stats with this tag so far today
                        properties:
                          sent:
                            type: integer
                            description: the number of emails sent with this tag so far today
                            example: 10
                          hard_bounces:
                            type: integer
                            description: the number of emails hard bounced with this tag so far today
                            example: 1
                          soft_bounces:
                            type: integer
                            description: the number of emails soft bounced with this tag so far today
                            example: 2
                          rejects:
                            type: integer
                            description: the number of emails rejected for sending this sender so far today
                            example: 1
                          complaints:
                            type: integer
                            description: the number of spam complaints with this tag so far today
                            example: 2
                          unsubs:
                            type: integer
                            description: the number of unsubscribes with this tag so far today
                            example: 1
                          opens:
                            type: integer
                            description: the number of times emails have been opened with this tag so far today
                            example: 50
                          unique_opens:
                            type: integer
                            description: the number of unique opens for emails sent with this tag so far today
                            example: 40
                          clicks:
                            type: integer
                            description: the number of URLs that have been clicked with this tag so far today
                            example: 25
                          unique_clicks:
                            type: integer
                            description: the number of unique clicks for emails sent with this tag so far today
                            example: 20
                      last_7_days:
                        type: object
                        description: stats with this tag in the last 7 days
                        properties:
                          sent:
                            type: integer
                            description: the number of emails sent with this tag in the last 7 days
                            example: 70
                          hard_bounces:
                            type: integer
                            description: the number of emails hard bounced with this tag in the last 7 days
                            example: 5
                          soft_bounces:
                            type: integer
                            description: the number of emails soft bounced with this tag in the last 7 days
                            example: 2
                          rejects:
                            type: integer
                            description: the number of emails rejected for sending this sender in the last 7 days
                            example: 1
                          complaints:
                            type: integer
                            description: the number of spam complaints with this tag in the last 7 days
                            example: 2
                          unsubs:
                            type: integer
                            description: the number of unsubscribes with this tag in the last 7 days
                            example: 1
                          opens:
                            type: integer
                            description: the number of times emails have been opened with this tag in the last 7 days
                            example: 50
                          unique_opens:
                            type: integer
                            description: the number of unique opens for emails sent with this tag in the last 7 days
                            example: 40
                          clicks:
                            type: integer
                            description: the number of URLs that have been clicked with this tag in the last 7 days
                            example: 70
                          unique_clicks:
                            type: integer
                            description: the number of unique clicks for emails sent with this tag in the last 7 days
                            example: 60
                      last_30_days:
                        type: object
                        description: stats with this tag in the last 30 days
                        properties:
                          sent:
                            type: integer
                            description: the number of emails sent with this tag in the last 30 days
                            example: 300
                          hard_bounces:
                            type: integer
                            description: the number of emails hard bounced with this tag in the last 30 days
                            example: 50
                          soft_bounces:
                            type: integer
                            description: the number of emails soft bounced with this tag in the last 30 days
                            example: 25
                          rejects:
                            type: integer
                            description: the number of emails rejected for sending this sender in the last 30 days
                            example: 10
                          complaints:
                            type: integer
                            description: the number of spam complaints with this tag in the last 30 days
                            example: 5
                          unsubs:
                            type: integer
                            description: the number of unsubscribes with this tag in the last 30 days
                            example: 1
                          opens:
                            type: integer
                            description: the number of times emails have been opened with this tag in the last 30 days
                            example: 100
                          unique_opens:
                            type: integer
                            description: the number of unique opens for emails sent with this tag in the last 30 days
                            example: 80
                          clicks:
                            type: integer
                            description: the number of URLs that have been clicked with this tag in the last 30 days
                            example: 60
                          unique_clicks:
                            type: integer
                            description: the number of unique clicks for emails sent with this tag in the last 30 days
                            example: 50
                      last_60_days:
                        type: object
                        description: stats with this tag in the last 60 days
                        properties:
                          sent:
                            type: integer
                            description: the number of emails sent with this tag in the last 60 days
                            example: 600
                          hard_bounces:
                            type: integer
                            description: the number of emails hard bounced with this tag in the last 60 days
                            example: 25
                          soft_bounces:
                            type: integer
                            description: the number of emails soft bounced with this tag in the last 60 days
                            example: 10
                          rejects:
                            type: integer
                            description: the number of emails rejected for sending this sender in the last 60 days
                            example: 5
                          complaints:
                            type: integer
                            description: the number of spam complaints with this tag in the last 60 days
                            example: 2
                          unsubs:
                            type: integer
                            description: the number of unsubscribes with this tag in the last 60 days
                            example: 1
                          opens:
                            type: integer
                            description: the number of times emails have been opened with this tag in the last 60 days
                            example: 100
                          unique_opens:
                            type: integer
                            description: the number of unique opens for emails sent with this tag in the last 60 days
                            example: 80
                          clicks:
                            type: integer
                            description: the number of URLs that have been clicked with this tag in the last 60 days
                            example: 50
                          unique_clicks:
                            type: integer
                            description: the number of unique clicks for emails sent with this tag in the last 60 days
                            example: 40
                      last_90_days:
                        type: object
                        description: stats with this tag in the last 90 days
                        properties:
                          sent:
                            type: integer
                            description: the number of emails sent with this tag in the last 90 days
                            example: 900
                          hard_bounces:
                            type: integer
                            description: the number of emails hard bounced with this tag in the last 90 days
                            example: 10
                          soft_bounces:
                            type: integer
                            description: the number of emails soft bounced with this tag in the last 90 days
                            example: 5
                          rejects:
                            type: integer
                            description: the number of emails rejected for sending this sender in the last 90 days
                            example: 2
                          complaints:
                            type: integer
                            description: the number of spam complaints with this tag in the last 90 days
                            example: 1
                          unsubs:
                            type: integer
                            description: the number of unsubscribes with this tag in the last 90 days
                            example: 0
                          opens:
                            type: integer
                            description: the number of times emails have been opened with this tag in the last 90 days
                            example: 100
                          unique_opens:
                            type: integer
                            description: the number of unique opens for emails sent with this tag in the last 90 days
                            example: 80
                          clicks:
                            type: integer
                            description: the number of URLs that have been clicked with this tag in the last 90 days
                            example: 50
                          unique_clicks:
                            type: integer
                            description: the number of unique clicks for emails sent with this tag in the last 90 days
                            example: 40
            application/x-php:
              schema:
                type: object
                description: the detailed information on the tag
                properties:
                  tag:
                    type: string
                    description: the actual tag as a string
                    example: my_tag
                  sent:
                    type: integer
                    description: the total number of messages sent with this tag
                    example: 100
                  hard_bounces:
                    type: integer
                    description: the tota

# --- truncated at 32 KB (80 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mailchimp/refs/heads/main/openapi/mailchimp-tags-api-openapi.yml