Sign in

3a702c095d22

latestOpenAPI 3.1.0MIT2026-08-08133230925.7 KB
Events

Get Event

Retrieve a specific event by its ID

get/events/{id}

Path parameters

idstring required

Query parameters

expandstring[]

If provided, expand the given field. (Only supported field: 'subscriber').

If provided, expand the given field. (Only supported field: 'subscriber').

Response

OK

idstring required

A unique TypeID associated with the object.

creation_datestring date-time required

The date and time at which the object was first created.

subscriber_idstring nullable

The ID of the subscriber the event is attributed to, if any.

email_idstring nullable

The ID of the email the event is attributed to, if any.

automation_idstring nullable

The ID of the automation that sent the email, if any.

metadataobject required

Event-type-specific metadata (e.g. clicked URL, bounce reason).

event_type'bounced' | 'clicked' | 'complained' | 'delivered' | 'opened' | 'rejected' | 'replied' | 'unsubscribed' required

The type of a subscriber event, such as a delivery, open, click, or reply.

Example response

{
  "subscriber": {
    "country": "US",
    "email_address": "telemachus@buttondown.email",
    "delivered_count": 12,
    "open_count": 7,
    "clicked_count": 3,
    "open_rate": 0.5833,
    "click_rate": 0.25
  },
  "email": {
    "slug": "welcome-to-the-newsletter"
  }
}