Get Email Delivery Status

Retrieve the delivery status of the sent Email(s).

Use this endpoint to retrieve the delivery status updates for the sent Email(s) in an easily parsable JSON format. The response will include the following delivery statuses as per the latest status of the sent Email:

  • Processed
  • Dropped
  • Deferred
  • Bounce
  • Delivered
  • Open
  • Click
  • Spam Report
  • Unsubscribe
Request
Security:
Bearer
path Parameters
id
required
string <uuid>

The queueId value received as response from the endpoints Email/Send Batch, Email/Single send, and Predefined Template SMS Send.

Responses
200

Success

400

Bad Request

401

Unauthorized

409

Conflict

422

Client Error

500

Server Error

get/email/{id}/status
Request samples
const fetch = require('node-fetch');

const id = 'YOUR_id_PARAMETER';
const resp = await fetch(
  `https://apiemail.mainbrainer.com/email/${id}/status`,
  {
    method: 'GET',
    headers: {
      Authorization: 'YOUR_API_KEY_HERE'
    }
  }
);

const data = await resp.text();
console.log(data);
Response samples
{
  • "Id": "string",
  • "Status": 0,
  • "StatusText": "string",
  • "StatusFailedReason": "string",
  • "Details": [
    • {
      • "Total": 0,
      • "Queued": 0,
      • "Submitted": 0,
      • "Delivered": 0,
      • "Failed": 0
      }
    ]
}