Get tag info

POST

https://mandrillapp.com/api/1.4/tags/info

POST

/api/1.4/tags/info

curl -X POST https://mandrillapp.com/api/1.4/tags/info \
     -H "Content-Type: application/json" \
     -d '{
  "key": "ONzNrsmbtNXoIKyfPmjnig",
  "tag": "example-tag"
}'

{
  "tag": "test",
  "sent": 1,
  "hard_bounces": 1,
  "soft_bounces": 1,
  "rejects": 1,
  "complaints": 1,
  "unsubs": 1,
  "opens": 1,
  "clicks": 1,
  "unique_opens": 1,
  "unique_clicks": 1,
  "reputation": 1,
  "stats": {
    "today": {
      "sent": 1,
      "hard_bounces": 1,
      "soft_bounces": 1,
      "rejects": 1,
      "complaints": 1,
      "unsubs": 1,
      "opens": 1,
      "unique_opens": 1,
      "clicks": 1,
      "unique_clicks": 1
    },
    "last_7_days": {
      "sent": 1,
      "hard_bounces": 1,
      "soft_bounces": 1,
      "rejects": 1,
      "complaints": 1,
      "unsubs": 1,
      "opens": 1,
      "unique_opens": 1,
      "clicks": 1,
      "unique_clicks": 1
    },
    "last_30_days": {
      "sent": 1,
      "hard_bounces": 1,
      "soft_bounces": 1,
      "rejects": 1,
      "complaints": 1,
      "unsubs": 1,
      "opens": 1,
      "unique_opens": 1,
      "clicks": 1,
      "unique_clicks": 1
    },
    "last_60_days": {
      "sent": 1,
      "hard_bounces": 1,
      "soft_bounces": 1,
      "rejects": 1,
      "complaints": 1,
      "unsubs": 1,
      "opens": 1,
      "unique_opens": 1,
      "clicks": 1,
      "unique_clicks": 1
    },
    "last_90_days": {
      "sent": 1,
      "hard_bounces": 1,
      "soft_bounces": 1,
      "rejects": 1,
      "complaints": 1,
      "unsubs": 1,
      "opens": 1,
      "unique_opens": 1,
      "clicks": 1,
      "unique_clicks": 1
    }
  }
}

Return more detailed information about a single tag, including aggregates of recent stats

Request

This endpoint expects an object.

keystringRequired

A valid Mandrill API key

tagstringRequired

An existing tag name

Response

Success

tagstring

Tag name

sentinteger

Total number of emails sent with this tag

hard_bouncesinteger

Total number of hard bounces for emails with this tag

soft_bouncesinteger

Total number of soft bounces for emails with this tag

rejectsinteger

Total number of rejected emails with this tag

complaintsinteger

Total number of spam complaints for emails with this tag

unsubsinteger

Total number of unsubscribe requests for emails with this tag

opensinteger

Total number of times emails with this tag have been opened

clicksinteger

Total number of tracked URLs clicked in emails with this tag

unique_opensinteger

Total number of unique opens for emails with this tag

unique_clicksinteger

Total number of unique clicks for emails with this tag

reputationinteger0-100

Tag reputation score on scale 0-100

statsobject

Aggregate summary of the tag's sending stats across different time windows

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error