Delivery & Status

Track the lifecycle of your emails, from queueing to delivery and engagement.

GET

/v1/email/status/:messageId

Request Parameters

Parameter	Type	Description
messageId	Path	The unique ID returned when the email was sent

Response

JSON

{
  "success": true,
  "data": {
    "messageId": "eml_xyz123abc",
    "status": "delivered",
    "recipient": "[email protected]",
    "events": [
      {
        "status": "queued",
        "timestamp": "2024-01-15T10:30:00Z"
      },
      {
        "status": "delivered",
        "timestamp": "2024-01-15T10:30:02Z"
      },
      {
        "status": "opened",
        "timestamp": "2024-01-15T10:45:12Z"
      }
    ]
  }
}

Status Types

queued

Email is in our processing queue

delivered

Successfully delivered to recipient's inbox

bounced

Hard bounce (invalid address or rejected)

deferred

Soft bounce, retrying delivery

opened

Recipient opened the email

clicked

Recipient clicked a link in the email

spam

Recipient marked email as spam

Pro Tip: Webhooks

While you can poll this endpoint to check status, we highly recommend using Webhooks to receive real-time updates when an email's status changes.