Mailchimp Developer Documentation

curl -X POST https://mandrillapp.com/api/1.4/rejects/list \
     -H "Content-Type: application/json" \
     -d '{
  "key": "ONzNrsmbtNXoIKyfPmjnig",
  "email": "user@example.com",
  "include_expired": false,
  "subaccount": "cust-123"
}'

[
  {
    "email": "user1@example.com",
    "reason": "hard-bounce",
    "detail": "550 5.1.1 User unknown",
    "created_at": "2023-01-15 10:30:00",
    "last_event_at": "2023-01-15 10:30:00",
    "expires_at": "2023-02-15 10:30:00",
    "expired": false,
    "sender": null,
    "subaccount": null
  },
  {
    "email": "user2@example.com",
    "reason": "spam",
    "detail": "Manually blocked due to spam complaints",
    "created_at": "2023-01-10 14:20:00",
    "last_event_at": "2023-01-10 14:20:00",
    "expires_at": "2023-02-10 14:20:00",
    "expired": false,
    "sender": {
      "address": "sender@example.com",
      "created_at": "2023-01-01 00:00:00",
      "sent": 100,
      "hard_bounces": 5,
      "soft_bounces": 2,
      "rejects": 7,
      "complaints": 1,
      "unsubs": 3
    },
    "subaccount": "subaccount-123"
  }
]

Retrieves your email rejection denylist. You can provide an email address to limit the results. Returns up to 1000 results. By default, entries that have expired are excluded from the results; set include_expired to true to include them.

Request

This endpoint expects an object.

keystringRequired

A valid Mandrill API key

emailstringOptional

An optional email address to search by

include_expiredbooleanOptional

Whether to include rejections that have already expired

subaccountstringOptional<=255 characters

An optional unique identifier for the subaccount to limit the blacklist

Response

Success

emailstringformat: "email"

The email that is blocked

reasonenum

The type of event that caused this rejection

Allowed values:

detailstring or null

Extended details about the event, such as the SMTP diagnostic for bounces or the comment for manually-created rejections, or null if none was recorded

created_atstringformat: "^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$"

When the email was added to the blocklist

last_event_atstringformat: "^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$"

The timestamp of the most recent event that either created or renewed this rejection

expires_atstring or nullformat: "^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$"

When the blocklist entry will expire (this may be in the past)

expiredboolean

Whether the blocklist entry has expired

senderobject or nullOptional

The sender that this blocklist entry applies to, or null if none

subaccountstring or nullOptional

The subaccount that this denylist entry applies to, or null if none

Errors

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error