Mailchimp

Mailchimp Users API

Retrieve information about the authenticated Mandrill account.

Documentation GitHub OpenAPI

Operations 4

POST /users/info Get user info #

POST /users/ping Ping #

POST /users/ping2 Ping 2 #

POST /users/senders List account senders #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/mailchimp-users-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  version: 1.4.1
  title: Mailchimp Transactional Users 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: users
paths:
  /users/info:
    post:
      x-custom-config:
        methodNameCamel: info
        methodNameSnake: info
      summary: Get user info
      description: Return the information about the API-connected user.
      operationId: postUsersInfo
      tags:
      - users
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                description: the user information including username, key, reputation, quota, and historical sending stats
                properties:
                  username:
                    type: string
                    description: the username of the user (used for SMTP authentication)
                    example: '31352262'
                  created_at:
                    type: string
                    description: the date and time that the user's Mandrill account was created as a UTC string in YYYY-MM-DD HH:MM:SS format
                    example: '2025-04-29 12:00:00'
                  public_id:
                    type: string
                    description: a unique, permanent identifier for this user
                    example: pJ9CSLA-VC12xQ9UArlvXA
                  reputation:
                    type: integer
                    description: the reputation of the user on a scale from 0 to 100, with 75 generally being a "good" reputation
                    example: 85
                  hourly_quota:
                    type: integer
                    description: the maximum number of emails Mandrill will deliver for this user each hour. Any emails beyond that will be accepted and queued for later delivery. Users with higher reputations will have higher hourly quotas
                    example: 500
                  backlog:
                    type: integer
                    description: the number of emails that are queued for delivery due to exceeding your monthly or hourly quotas
                    example: 0
                  stats:
                    type: object
                    description: an aggregate summary of the account's sending stats
                    properties:
                      today:
                        type: object
                        description: stats for this user so far today
                        properties:
                          sent:
                            type: integer
                            description: the number of emails sent for this user so far today
                            example: 100
                          hard_bounces:
                            type: integer
                            description: the number of emails hard bounced for this user so far today
                            example: 2
                          soft_bounces:
                            type: integer
                            description: the number of emails soft bounced for this user so far today
                            example: 1
                          rejects:
                            type: integer
                            description: the number of emails rejected for sending this sender so far today
                            example: 0
                          complaints:
                            type: integer
                            description: the number of spam complaints for this user so far today
                            example: 0
                          unsubs:
                            type: integer
                            description: the number of unsubscribes for this user so far today
                            example: 0
                          opens:
                            type: integer
                            description: the number of times emails have been opened for this user so far today
                            example: 10
                          unique_opens:
                            type: integer
                            description: the number of unique opens for emails sent for this user so far today
                            example: 7
                          clicks:
                            type: integer
                            description: the number of URLs that have been clicked for this user so far today
                            example: 8
                          unique_clicks:
                            type: integer
                            description: the number of unique clicks for emails sent for this user so far today
                            example: 5
                      last_7_days:
                        type: object
                        description: stats for this user in the last 7 days
                        properties:
                          sent:
                            type: integer
                            description: the number of emails sent for this user in the last 7 days
                            example: 700
                          hard_bounces:
                            type: integer
                            description: the number of emails hard bounced for this user in the last 7 days
                            example: 2
                          soft_bounces:
                            type: integer
                            description: the number of emails soft bounced for this user in the last 7 days
                            example: 1
                          rejects:
                            type: integer
                            description: the number of emails rejected for sending this sender in the last 7 days
                            example: 0
                          complaints:
                            type: integer
                            description: the number of spam complaints for this user in the last 7 days
                            example: 0
                          unsubs:
                            type: integer
                            description: the number of unsubscribes for this user in the last 7 days
                            example: 0
                          opens:
                            type: integer
                            description: the number of times emails have been opened for this user in the last 7 days
                            example: 50
                          unique_opens:
                            type: integer
                            description: the number of unique opens for emails sent for this user in the last 7 days
                            example: 10
                          clicks:
                            type: integer
                            description: the number of URLs that have been clicked for this user in the last 7 days
                            example: 20
                          unique_clicks:
                            type: integer
                            description: the number of unique clicks for emails sent for this user in the last 7 days
                            example: 5
                      last_30_days:
                        type: object
                        description: stats for this user in the last 30 days
                        properties:
                          sent:
                            type: integer
                            description: the number of emails sent for this user in the last 30 days
                            example: 3000
                          hard_bounces:
                            type: integer
                            description: the number of emails hard bounced for this user in the last 30 days
                            example: 100
                          soft_bounces:
                            type: integer
                            description: the number of emails soft bounced for this user in the last 30 days
                            example: 50
                          rejects:
                            type: integer
                            description: the number of emails rejected for sending this sender in the last 30 days
                            example: 5
                          complaints:
                            type: integer
                            description: the number of spam complaints for this user in the last 30 days
                            example: 10
                          unsubs:
                            type: integer
                            description: the number of unsubscribes for this user in the last 30 days
                            example: 2
                          opens:
                            type: integer
                            description: the number of times emails have been opened for this user in the last 30 days
                            example: 500
                          unique_opens:
                            type: integer
                            description: the number of unique opens for emails sent for this user in the last 30 days
                            example: 100
                          clicks:
                            type: integer
                            description: the number of URLs that have been clicked for this user in the last 30 days
                            example: 200
                          unique_clicks:
                            type: integer
                            description: the number of unique clicks for emails sent for this user in the last 30 days
                            example: 50
                      last_60_days:
                        type: object
                        description: stats for this user in the last 60 days
                        properties:
                          sent:
                            type: integer
                            description: the number of emails sent for this user in the last 60 days
                            example: 6000
                          hard_bounces:
                            type: integer
                            description: the number of emails hard bounced for this user in the last 60 days
                            example: 100
                          soft_bounces:
                            type: integer
                            description: the number of emails soft bounced for this user in the last 60 days
                            example: 50
                          rejects:
                            type: integer
                            description: the number of emails rejected for sending this sender in the last 60 days
                            example: 10
                          complaints:
                            type: integer
                            description: the number of spam complaints for this user in the last 60 days
                            example: 5
                          unsubs:
                            type: integer
                            description: the number of unsubscribes for this user in the last 60 days
                            example: 2
                          opens:
                            type: integer
                            description: the number of times emails have been opened for this user in the last 60 days
                            example: 300
                          unique_opens:
                            type: integer
                            description: the number of unique opens for emails sent for this user in the last 60 days
                            example: 250
                          clicks:
                            type: integer
                            description: the number of URLs that have been clicked for this user in the last 60 days
                            example: 400
                          unique_clicks:
                            type: integer
                            description: the number of unique clicks for emails sent for this user in the last 60 days
                            example: 350
                      last_90_days:
                        type: object
                        description: stats for this user in the last 90 days
                        properties:
                          sent:
                            type: integer
                            description: the number of emails sent for this user in the last 90 days
                            example: 9000
                          hard_bounces:
                            type: integer
                            description: the number of emails hard bounced for this user in the last 90 days
                            example: 100
                          soft_bounces:
                            type: integer
                            description: the number of emails soft bounced for this user in the last 90 days
                            example: 50
                          rejects:
                            type: integer
                            description: the number of emails rejected for sending this sender in the last 90 days
                            example: 10
                          complaints:
                            type: integer
                            description: the number of spam complaints for this user in the last 90 days
                            example: 5
                          unsubs:
                            type: integer
                            description: the number of unsubscribes for this user in the last 90 days
                            example: 2
                          opens:
                            type: integer
                            description: the number of times emails have been opened for this user in the last 90 days
                            example: 4500
                          unique_opens:
                            type: integer
                            description: the number of unique opens for emails sent for this user in the last 90 days
                            example: 3000
                          clicks:
                            type: integer
                            description: the number of URLs that have been clicked for this user in the last 90 days
                            example: 1500
                          unique_clicks:
                            type: integer
                            description: the number of unique clicks for emails sent for this user in the last 90 days
                            example: 1000
                      all_time:
                        type: object
                        description: tats for the lifetime of the user's account
                        properties:
                          sent:
                            type: integer
                            description: the number of emails sent in the lifetime of the user's account
                            example: 12345
                          hard_bounces:
                            type: integer
                            description: the number of emails hard bounced in the lifetime of the user's account
                            example: 100
                          soft_bounces:
                            type: integer
                            description: the number of emails soft bounced in the lifetime of the user's account
                            example: 50
                          rejects:
                            type: integer
                            description: the number of emails rejected for sending this user so far today
                            example: 5
                          complaints:
                            type: integer
                            description: the number of spam complaints in the lifetime of the user's account
                            example: 10
                          unsubs:
                            type: integer
                            description: the number of unsubscribes in the lifetime of the user's account
                            example: 2
                          opens:
                            type: integer
                            description: the number of times emails have been opened in the lifetime of the user's account
                            example: 4500
                          unique_opens:
                            type: integer
                            description: the number of unique opens for emails sent in the lifetime of the user's account
                            example: 3000
                          clicks:
                            type: integer
                            description: the number of URLs that have been clicked in the lifetime of the user's account
                            example: 1500
                          unique_clicks:
                            type: integer
                            description: the number of unique clicks for emails sent in the lifetime of the user's account
                            example: 1000
            application/x-php:
              schema:
                type: object
                description: the user information including username, key, reputation, quota, and historical sending stats
                properties:
                  username:
                    type: string
                    description: the username of the user (used for SMTP authentication)
                    example: '31352262'
                  created_at:
                    type: string
                    description: the date and time that the user's Mandrill account was created as a UTC string in YYYY-MM-DD HH:MM:SS format
                    example: '2025-04-29 12:00:00'
                  public_id:
                    type: string
                    description: a unique, permanent identifier for this user
                    example: pJ9CSLA-VC12xQ9UArlvXA
                  reputation:
                    type: integer
                    description: the reputation of the user on a scale from 0 to 100, with 75 generally being a "good" reputation
                    example: 85
                  hourly_quota:
                    type: integer
                    description: the maximum number of emails Mandrill will deliver for this user each hour. Any emails beyond that will be accepted and queued for later delivery. Users with higher reputations will have higher hourly quotas
                    example: 500
                  backlog:
                    type: integer
                    description: the number of emails that are queued for delivery due to exceeding your monthly or hourly quotas
                    example: 0
                  stats:
                    type: object
                    description: an aggregate summary of the account's sending stats
                    properties:
                      today:
                        type: object
                        description: stats for this user so far today
                        properties:
                          sent:
                            type: integer
                            description: the number of emails sent for this user so far today
                            example: 100
                          hard_bounces:
                            type: integer
                            description: the number of emails hard bounced for this user so far today
                            example: 2
                          soft_bounces:
                            type: integer
                            description: the number of emails soft bounced for this user so far today
                            example: 1
                          rejects:
                            type: integer
                            description: the number of emails rejected for sending this sender so far today
                            example: 0
                          complaints:
                            type: integer
                            description: the number of spam complaints for this user so far today
                            example: 0
                          unsubs:
                            type: integer
                            description: the number of unsubscribes for this user so far today
                            example: 0
                          opens:
                            type: integer
                            description: the number of times emails have been opened for this user so far today
                            example: 10
                          unique_opens:
                            type: integer
                            description: the number of unique opens for emails sent for this user so far today
                            example: 7
                          clicks:
                            type: integer
                            description: the number of URLs that have been clicked for this user so far today
                            example: 8
                          unique_clicks:
                            type: integer
                            description: the number of unique clicks for emails sent for this user so far today
                            example: 5
                      last_7_days:
                        type: object
                        description: stats for this user in the last 7 days
                        properties:
                          sent:
                            type: integer
                            description: the number of emails sent for this user in the last 7 days
                            example: 700
                          hard_bounces:
                            type: integer
                            description: the number of emails hard bounced for this user in the last 7 days
                            example: 2
                          soft_bounces:
                            type: integer
                            description: the number of emails soft bounced for this user in the last 7 days
                            example: 1
                          rejects:
                            type: integer
                            description: the number of emails rejected for sending this sender in the last 7 days
                            example: 0
                          complaints:
                            type: integer
                            description: the number of spam complaints for this user in the last 7 days
                            example: 0
                          unsubs:
                            type: integer
                            description: the number of unsubscribes for this user in the last 7 days
                            example: 0
                          opens:
                            type: integer
                            description: the number of times emails have been opened for this user in the last 7 days
                            example: 50
                          unique_opens:
                            type: integer
                            description: the number of unique opens for emails sent for this user in the last 7 days
                            example: 10
                          clicks:
                            type: integer
                            description: the number of URLs that have been clicked for this user in the last 7 days
                            example: 20
                          unique_clicks:
                            type: integer
                            description: the number of unique clicks for emails sent for this user in the last 7 days
                            example: 5
                      last_30_days:
                        type: object
                        description: stats for this user in the last 30 days
                        properties:
                          sent:
                            type: integer
                            description: the number of emails sent for this user in the last 30 days
                            example: 3000
                          hard_bounces:
                            type: integer
                            description: the number of emails hard bounced for this user in the last 30 days
                            example: 100
                          soft_bounces:
                            type: integer
                            description: the number of emails soft bounced for this user in the last 30 days
                            example: 50
                          rejects:
                            type: integer
                            description: the number of emails rejected for sending this sender in the last 30 days
                            example: 5
                          complaints:
                            type: integer
                            description: the number of spam complaints for this user in the last 30 days
                            example: 10
                          unsubs:
                            type: integer
                            description: the number of unsubscribes for this user in the last 30 days
                            example: 2
                          opens:
                            type: integer
                            description: the number of times emails have been opened for this user in the last 30 days
                            example: 500
                          unique_opens:
                            type: integer
                            description: the number of unique opens for emails sent for this user in the last 30 days
                            example: 100
                          clicks:
                            type: integer
                            description: the number of URLs that have been clicked for this user in the last 30 days
                            example: 200
                          unique_clicks:
                            type: integer
                            description: the number of unique clicks for emails sent for this user in the last 30 days
                            example: 50
                      last_60_days:
                        type: object
                        description: stats for this user in the last 60 days
                        properties:
                          sent:
                            type: integer
                            description: the number of emails sent for this user in the last 60 days
                            example: 6000
                          hard_bounces:
                            type: integer
                            description: the number of emails hard bounced for this user in the last 60 days
                            example: 100
                          soft_bounces:
                            type: integer
                            description: the number of emails soft bounced for this user in the last 60 days
                            example: 50
                          rejects:
                            type: integer
                            description: the number of emails rejected for sending this sender in the last 60 days
                            example: 10
                          complaints:
                            type: integer
                            description: the number of spam complaints for this user in the last 60 days
                            example: 5
                          unsubs:
                            type: integer
                            description: the number of unsubscribes for this user in the last 60 days
                            example: 2
                          opens:
                            type: integer
                            description: the number of times emails have been opened for this user in the last 60 days
                            example: 300
                          unique_opens:
                            type: integer
                            description: the number of unique opens for emails sent for this user in the last 60 days
                            example: 250
                          clicks:
                            type: integer
                            description: the number of URLs that have been clicked for this user in the last 60 days
                            example: 400
                          unique_clicks:
                            type: integer
                            description: the number of unique clicks for emails sent for this user in the last 60 days
                            example: 350
                      last_90_days:
                        type: object
                        description: stats for this user in the last 90 days
                        properties:
                          sent:
                            type: integer
                            description: the number of emails sent for this user in the last 90 days
                            example: 9000
                          hard_bounces:
                            type: integer
                            description: the number of emails hard bounced for this user in the last 90 days
                            example: 100
                          soft_bounces:
                            type: integer
                            description: the number of emails soft bounced for this user in the last 90 days
                            example: 50
                          rejects:
                            type: integer
                            description: the number of emails rejected for sending this sender in the last 90 days
                            example: 10
                          complaints:
                            type: integer
                            description: the number of spam complaints for this user in the last 90 days
                            example: 5
                          unsubs:
                            type: integer
                            description: the number of unsubscribes for this user in the last 90 days
                            example: 2
                          opens:
                            type: integer
                            description: the number of times emails have been opened for this user in the last 90 days
                            example: 4500
                          unique_opens:
                            type: integer
                            description: the number of unique opens for emails sent for this user in the last 90 days
                            example: 3000
                          clicks:
                            type: integer
                            description: the number of URLs that have been clicked for this user in the last 90 days
                            example: 1500
                          unique_clicks:
                            type: integer
                            description: the number of unique clicks for emails sent for this user in the last 90 days
                            example: 1000
                      all_time:
                        type: object
                        description: tats for the lifetime of the user's account
                        properties:
                          sent:
                            type: integer
                            description: the number of emails sent in the lifetime of the user's account
                            example: 12345
                          hard_bounces:
                            type: integer
                            description: the number of emails hard bounced in the lifetime of the user's account
                            example: 100
                          soft_bounces:
                            type: integer
                            description: the number of emails soft bounced in the lifetime of the user's account
                            example: 50
                          rejects:
                            type: integer
                            description: the number of emails rejected for sending this user so far today
                            example: 5
                          complaints:
                            type: integer
                        

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

Mailchimp Users API

Operations 4

Documentation

Specifications

Schemas & Data

Other Resources