Symmetric filters on survey responses

All three survey-response filters take lists, and survey is now survey_id

May 4, 2026
Breaking API change

This is a backwards-incompatible change to Buttondown's API. Pinning your newsletter or request to an older API version keeps the previous behavior where a version was cut for it.

The filters on GET /v1/survey_responses are now symmetric. All three filters accept multiple IDs, and survey has been renamed to survey_id to match the rest of the API.

BeforeAfter
email_id (single)email_id (list)
subscriber_id (single)subscriber_id (list)
survey (list)survey_id (list)

Existing requests passing a single value to email_id or subscriber_id continue to work. Requests using survey=... must be updated to survey_id=....

We didn't bump the API version for this — /v1/survey_responses is a niche endpoint and we don't expect anyone to be relying on the survey parameter name. If this change breaks your workflow, email us at [email protected] and we'll figure something out.

Buttondown is the last email platform you’ll switch to.