Buttondown Documentation

Buttondown Documentation

© 2016–2025 Buttondown LLC.

TwitterGitHubLinkedInMastodonBlueskyFacebook

2025-03-25

You can now filter subscribers by their undeliverability status and specific reasons for being marked undeliverable. This helps you better manage your list health and diagnostics.

A new field undeliverability_reason has been added to the Subscriber model which can be used for filtering:

import requests

url = "https://api.buttondown.com/v1/subscribers"
headers = {
  "Authorization": "Token $BUTTONDOWN_API_KEY"
}
params = {
  "undeliverability_reason": "email_blocked"
}

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

You can also filter by undeliverability date range:

import requests

url = "https://api.buttondown.com/v1/subscribers"
headers = {
  "Authorization": "Token $BUTTONDOWN_API_KEY"
}
params = {
  "undeliverability_date__start": "2025-01-01",
  "undeliverability_date__end": "2025-03-25"
}

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

Check out the undeliverability reasons documentation to see all possible values.

Related

Stay informed

You can subscribe to this changelog via RSS or browse the full list of API changes.

© 2016–2025 Buttondown LLC.

TwitterGitHubLinkedInMastodonBlueskyFacebook