API reference

List emails

GET/api/v2/emails

Lists emails sent through the API, newest first. Needs a full access key.

Query parameters

ParameterDescription
limitHow many to return, 1 to 100. Default 20.
statusOnly emails whose latest status is this: queued, sent, delivered, delivery_delayed, bounced, complained, failed or suppressed.
afterAn email ID from the previous page: returns the emails sent before it.

Example

curl "https://robustemail.com/api/v2/emails?limit=2&status=bounced" \
  -H "Authorization: Bearer $ROBUSTEMAIL_API_KEY"

Response

{
  "object": "list",
  "has_more": true,
  "data": [
    {
      "object": "email",
      "id": "6adc79043cbea",
      "from": "Acme <hello@acme.com>",
      "to": ["jane@example.com"],
      "cc": null,
      "bcc": null,
      "reply_to": null,
      "subject": "Your receipt",
      "tags": [{ "name": "category", "value": "receipt" }],
      "last_event": "bounced",
      "mode": "live",
      "created_at": "2026-10-25T09:30:12+00:00",
      "sent_at": "2026-10-25T09:30:14+00:00"
    }
  ]
}

The list leaves out the html and text bodies. Get them with Retrieve email.

Paging

When has_more is true, request the next page with after set to the last id you received:

curl "https://robustemail.com/api/v2/emails?limit=100&after=6adc79043cbea" \
  -H "Authorization: Bearer $ROBUSTEMAIL_API_KEY"