Skip to main content
POST
/
v2
/
exports
/
email-events
curl --request POST \
  --url https://pub-api.conversion.ai/api/v2/exports/email-events \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "eventType": "EMAIL_OPEN",
  "limit": 1000
}
'
{
  "data": {
    "events": [
      {
        "eventId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "contactId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "occurredAt": "2026-06-01T10:00:00Z",
        "eventType": "EMAIL_OPEN",
        "sourceType": "BLAST",
        "sourceId": "d4e5f6a7-b8c9-0123-def0-456789abcdef",
        "emailId": "c3d4e5f6-a7b8-9012-cdef-123456789012",
        "emailName": "June Newsletter",
        "sentEmailId": "e5f6a7b8-c9d0-1234-ef01-56789abcdef0",
        "isBot": false,
        "link": null,
        "topicIds": null,
        "bounceType": null,
        "errorMessage": null
      }
    ]
  },
  "pagination": {
    "nextCursor": "eyJjcmVhdGVkQXQiOiIyMDI2LTA2LTAxVDEwOjAwOjAwWiJ9"
  }
}

Authorizations

​
X-API-Key
string
header
required

Your Conversion API key. Found in Settings > Integrations in the dashboard. Format: sk_live_<key_id>_<secret>.

Body

application/json
​
eventType
enum<string>
required

The email event type to export. Each call exports a single event type, matched 1:1 against the underlying email event type. Case-insensitive; an unsupported value returns an invalid_field error.

Available options:
EMAIL_SEND,
EMAIL_DELIVERY,
EMAIL_OPEN,
EMAIL_CLICK,
EMAIL_BOUNCE,
EMAIL_SOFT_BOUNCE,
EMAIL_COMPLAINT,
EMAIL_UNSUBSCRIBE_ALL,
EMAIL_TOPIC_UNSUBSCRIBE
Example:

"EMAIL_OPEN"

​
cursor
string

The opaque pagination cursor returned as pagination.nextCursor by a previous call. Omit (or pass an empty string) to fetch the first page. An invalid or malformed cursor returns an invalid_cursor error.

Example:

"eyJjcmVhdGVkQXQiOiIyMDI2LTA2LTAxVDEwOjAwOjAwWiJ9"

​
limit
integer
default:1000

The maximum number of events to return per page. Defaults to 1000. Values are clamped to the range [1, 5000] rather than rejected; values above 5000 return 5000 results.

Required range: 1 <= x <= 5000

Response

A page of email events retrieved successfully.

​
data
object
​
pagination
object