Returns all recipients’ delivery and open statuses for a given message UID.

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

Request

{
  "api_key" : "PROJECT_API_KEY",
  "uid" : "uid_of_the_message"
}

Response 200 OK

{
  "response": {
    "status": "ok",
    "uid": "uid_of_the_message"
  },
  "data": {
    "message": {
      "id": "id_of_the_message"
    },
    "transmissions": {
      "test@example.org": {
        "status": "completed",
        "created_at": "2012-07-04 18:58:57",
        "failed_at": null,
        "opened_at": "2012-07-04 19:59:22",
        "result_code": "SMTP_250",
        "result_message": "2.0.0 OK 123456789 abc123"
      },
      "sample@example.com": {
        "status": "retry",
        "created_at": "2012-07-04 18:58:57",
        "failed_at": null,
        "opened_at": null,
        "result_code": null,
        "result_message": null
      },
      "bad@example.org": {
        "status": "failed",
        "created_at": "2012-07-04 18:58:57",
        "failed_at": "2012-07-04 18:58:59",
        "opened_at": null,
        "result_code": "SMTP_554",
        "result_message": "User does not exist"
      }
    }
  }
}

Messages may be retried for up to 24 hours. Beyond this point only the opened_at parameter is liable to update.

Response time is proportional to the number of recipients on a given message.

If polling this endpoint, we recommend syncing at most hourly. If you have specific requirements beyond this, please email info@postageapp.com.

comments powered by Disqus