Returns a list of all recipients in a suppressed state. This includes email addressses which are not receiving email because they are having temporary problems, such as mailbox full, mail server not responding, as well as those that are more permanent in nature, such as account deleted, or spam reports from the recipient.

URL: https://api.postageapp.com/v.1.0/get_suppression_list.json

Request

{
   "api_key" : "PROJECT_API_KEY"
}

Response 200 OK

{
  "response": {
    "status": "ok",
    "uid": null
  },
  "data": {
    "email1@example.com": {
      "status" : "rejected",
      "suppression_state" : "hard_bounce",
      "blocked_until" : "2014-02-09T17:32:31Z",
      "message" : "No Such User Here"
    }
    "email2@example.org" : {
      "status" : "warning",
      "suppression_state" : "soft_bounce",
      "blocked_until" : "2014-04-07T17:32:31Z",
      "message" : "Requested action not taken: mailbox temporarily unavailable"
  }
}
comments powered by Disqus