Buttondown logo

Get started

Introduction2026-02-262026-02-162026-02-092026-02-072026-02-062026-01-242026-01-222026-01-122025-11-152025-09-232025-09-182025-07-282025-07-132025-06-262025-06-012025-05-302025-05-192025-05-172025-05-142025-04-172025-04-142025-03-312025-03-252025-03-012025-02-262025-02-122025-02-062025-01-022024-12-312024-12-302024-12-142024-12-112024-12-102024-12-092024-12-052024-09-302024-08-152024-08-012024-07-132024-06-272024-06-212024-05-222024-04-032023-08-232023-08-212023-07-232022-11-242022-11-192022-03-082021-11-262021-08-272021-01-022020-12-232020-12-09

Routes

Buttondown logo

2026-02-06

Subscribers now include engagement counts and rates in the /v1/subscribers response:

  • delivered_count
  • open_count
  • clicked_count
  • open_rate
  • click_rate

You can also filter and order by these rates:

  • Order by open_rate / click_rate (ascending or descending, via ordering=...)
  • Filter by open_rate__start / open_rate__end and click_rate__start / click_rate__end

Rates are computed from engagement counts; if a subscriber has no deliveries, the rates are null.

Example:

curl "https://api.buttondown.com/v1/subscribers" \
  -H "Authorization: Token YOUR_API_KEY" \
  -G \
  --data-urlencode "ordering=-open_rate" \
  --data-urlencode "open_rate__start=0.5"

{
  "count": 1,
  "results": [
    {
      "id": "9f4c9a1e-0d2c-4a44-8a4f-cc06e97a9df2",
      "email_address": "telemachus@buttondown.email",
      "delivered_count": 12,
      "open_count": 7,
      "clicked_count": 3,
      "open_rate": 0.5833,
      "click_rate": 0.25
    }
  ]
}

Stay informed

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