Buttondown Documentation

Buttondown Documentation

© 2016–2025 Buttondown LLC.

TwitterGitHubLinkedInMastodonBlueskyFacebook

Retrieving an event

Sample requests

These sample requests are autogenerated by the OpenAPI spec. This endpoint requires one or more parameters in the URL: those are offset in curly-braces.

import requests

url = "https://api.buttondown.com/v1/events/{id}"
headers = {
  "Authorization": "Token $BUTTONDOWN_API_KEY"
}

response = requests.request("GET", url, headers=headers)
print(response.text)

Sample responses

The IDs and values referenced in these responses are fake; please only rely on these responses for overall structure.

{
    "id": "13121cd6-0dfc-424c-bb12-988b0a32fcb3",
    "subscriber_id": "13121cd6-0dfc-424c-bb12-988b0a32fcb3",
    "email_id": null,
    "automation_id": null,
    "creation_date": "2020-09-29T00:00:00+00:00",
    "metadata": {},
    "event_type": "opened",
    "subscriber": null,
    "email": null,
    "automation": null
}

Path parameters

Consult the Filtering documentation for more information on how to filter and sort your requests.

expand

Type
array
Description

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

© 2016–2025 Buttondown LLC.

TwitterGitHubLinkedInMastodonBlueskyFacebook