Mailchimp Developer Documentation

[
  {
    "_id": "string",
    "bounce_description": "string",
    "clicks": 1,
    "clicks_detail": [
      {
        "ip": "string",
        "location": "string",
        "ts": 1,
        "ua": "string",
        "url": "string"
      }
    ],
    "diag": "string",
    "email": "user@example.com",
    "mc_template": "string",
    "metadata": {},
    "opens": 1,
    "opens_detail": [
      {
        "ip": "string",
        "location": "string",
        "ts": 1,
        "ua": "string"
      }
    ],
    "reject": {
      "last_event_at": "string",
      "reason": "string"
    },
    "resends": [
      {}
    ],
    "sender": "user@example.com",
    "smtp_events": [
      {
        "destination_ip": "198.2.132.48",
        "diag": "string",
        "size": 1,
        "source_ip": "string",
        "ts": 1,
        "type": "sent"
      }
    ],
    "state": "sent",
    "subaccount": "string",
    "subject": "string",
    "tags": [
      "string"
    ],
    "template": "string",
    "ts": 1
  }
]

Search recently sent messages and optionally narrow by date range, tags, senders, and API keys. Results can include both email and SMS messages. If no date range is specified, results within the last 7 days are returned.

Request

This endpoint expects an object.

keystringRequired

A valid Mandrill API key

querystringOptional

search terms to find matching messages

date_fromdate or nullOptional

start date

date_todate or nullOptional

end date

tagslist of strings or nullOptional

an array of tag names to narrow the search to

senderslist of strings or nullOptional

an array of sender addresses to narrow the search to

api_keyslist of strings or nullOptional

an array of API keys to narrow the search to

limitintegerOptional1-1000

the maximum number of results to return, defaults to 100, upper limit of 1000

Response

Success

MessagesEmailInfoobject

Detailed information about a sent email message

MessagesSmsInfoobject

Detailed information about a sent SMS message

Errors

401

Unauthorized Error

500

Internal Server Error

503

Service Unavailable Error