--- title: "Changes to List Emails" method: GET path: "/emails" --- # Changes to List Emails `GET /emails` > Every recorded change to this operation, newest first. ## Timeline Changed in 13 of 43 revisions. - **2026-10-29** `3c93095b1b8a`: 1 info - **2026-10-27** `8fff9c6b1347`: 2 breaking, 1 warning, 1 info - **2026-10-20** `bc6be78752aa`: 1 info - **2026-09-22** `f00fce908264`: 1 warning, 2 info - **2026-08-08** `3a702c095d22`: 1 warning, 1 info - **2026-07-26** `fc5d382abadb`: 1 warning, 1 info - **2026-07-13** `228cc05ba97d`: 4 breaking, 1 warning, 7 info - **2026-06-07** `13f3bc084194`: 14 breaking, 39 warning, 27 info - **2026-01-17** `8590daeecaea`: 2 breaking, 1 warning, 5 info - **2025-10-15** `b366d059d1ae`: 7 breaking, 4 warning, 15 info - **2025-07-11** `b3fb230c0938`: 9 breaking, 32 info - **2025-03-24** `b318723a4d8d`: 3 breaking, 10 info - **2025-02-18** `7b086652e3cf`: 4 breaking, 8 info ## Changes - **2026-10-29** `3c93095b1b8a`: 1 info - added the new optional `query` request parameter `image_id` - **2026-10-27** `8fff9c6b1347`: 2 breaking, 1 warning, 1 info - removed the enum value `suppressed` from the property `items/` of the `query` request parameter `-status` - removed the enum value `suppressed` from the property `items/` of the `query` request parameter `status` - removed the optional property `results/items/suppression_reason` from the response with the `200` status - removed the `suppressed` enum value from the `results/items/status` response property for the response status `200` - **2026-10-20** `bc6be78752aa`: 1 info - added the optional property `results/items/analytics/anyOf[subschema #1: Analytics]/attempts` to the response with the `200` status - **2026-09-22** `f00fce908264`: 1 warning, 2 info - added the new `partially_sent` enum value to the `results/items/status` response property for the response status `200` - added the enum value `partially_sent` to the property `items/` of the `query` request parameter `-status` - added the enum value `partially_sent` to the property `items/` of the `query` request parameter `status` - **2026-08-08** `3a702c095d22`: 1 warning, 1 info - added the new `archive_only` enum value to the `results/items/archival_mode` response property for the response status `200` - added the enum value `archive_only` to the property `items/` of the `query` request parameter `archival_mode` - **2026-07-26** `fc5d382abadb`: 1 warning, 1 info - added the new `smtp` enum value to the `results/items/source` response property for the response status `200` - added the enum value `smtp` to the property `items/` of the `query` request parameter `source` - **2026-07-13** `228cc05ba97d`: 4 breaking, 1 warning, 7 info - for the `query` request parameter `creation_date__end`, the format changed from no format to `date` - for the `query` request parameter `creation_date__start`, the format changed from no format to `date` - for the `query` request parameter `publish_date__end`, the format changed from no format to `date` - for the `query` request parameter `publish_date__start`, the format changed from no format to `date` - added the new `custom` enum value to the `results/items/template/anyOf[subschema #1: EmailTemplate]/` response property for the response status `200` - added the new optional `query` request parameter `page` - removed the pattern `^\d{4}-\d{2}-\d{2}$` from the `query` request parameter `creation_date__end` - removed the pattern `^\d{4}-\d{2}-\d{2}$` from the `query` request parameter `creation_date__start` - removed the pattern `^\d{4}-\d{2}-\d{2}$` from the `query` request parameter `publish_date__end` - removed the pattern `^\d{4}-\d{2}-\d{2}$` from the `query` request parameter `publish_date__start` - added the non-success response with the status `422` - added the non-success response with the status `429` - **2026-06-07** `13f3bc084194`: 14 breaking, 39 warning, 27 info - for the `query` request parameter `excluded_fields`, default value `` was removed - for the `query` request parameter `source`, default value `` was removed - the response property `code` became optional for the status `400` - response property `next` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `previous` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `results/items/attachments` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `results/items/publish_date` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `results/items/secondary_id` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `results/items/slug` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - the `code` response's property type changed from no type to `string` for status `403` - the `code` response's property type changed from `string` to no type for status `400` - the `results/items/analytics` response's property type changed from `object` to no type for status `200` - the `results/items/source` response's property type changed from no type to `string` for status `200` - the `results/items/status` response's property type changed from no type to `string` for status `200` - deleted the `query` request parameter `negative_status` - removed the optional property `results/items/analytics/clicks` from the response with the `200` status - removed the optional property `results/items/analytics/comments` from the response with the `200` status - removed the optional property `results/items/analytics/complaints` from the response with the `200` status - removed the optional property `results/items/analytics/deliveries` from the response with the `200` status - removed the optional property `results/items/analytics/opens` from the response with the `200` status - removed the optional property `results/items/analytics/page_views_30` from the response with the `200` status - removed the optional property `results/items/analytics/page_views_7` from the response with the `200` status - removed the optional property `results/items/analytics/page_views_lifetime` from the response with the `200` status - removed the optional property `results/items/analytics/paid_subscriptions` from the response with the `200` status - removed the optional property `results/items/analytics/permanent_failure_breakdown` from the response with the `200` status - removed the optional property `results/items/analytics/permanent_failures` from the response with the `200` status - removed the optional property `results/items/analytics/recipients` from the response with the `200` status - removed the optional property `results/items/analytics/replies` from the response with the `200` status - removed the optional property `results/items/analytics/social_mentions` from the response with the `200` status - removed the optional property `results/items/analytics/subscriptions` from the response with the `200` status - removed the optional property `results/items/analytics/survey_responses` from the response with the `200` status - removed the optional property `results/items/analytics/temporary_failure_breakdown` from the response with the `200` status - removed the optional property `results/items/analytics/temporary_failures` from the response with the `200` status - removed the optional property `results/items/analytics/unsubscriptions` from the response with the `200` status - removed the optional property `results/items/analytics/webmentions` from the response with the `200` status - added the new `about_to_send` enum value to the `results/items/status` response property for the response status `200` - added the new `api` enum value to the `results/items/source` response property for the response status `200` - added the new `app` enum value to the `results/items/source` response property for the response status `200` - added the new `deleted` enum value to the `results/items/status` response property for the response status `200` - added the new `draft` enum value to the `results/items/status` response property for the response status `200` - …40 more - **2026-01-17** `8590daeecaea`: 2 breaking, 1 warning, 5 info - the `results/items/attachments/items/` response's property type changed from no type to `string` for status `200` - the `results/items/id` response's property format changed from `uuid` to no format for status `200` - deleted the `query` request parameter `automations` - added the new optional `query` request parameter `attachments` - for the `query` request parameter `ids`, the format of property `items/` was generalized from `uuid` to no format - added the optional property `results/items/analytics/permanent_failure_breakdown` to the response with the `200` status - added the optional property `results/items/analytics/temporary_failure_breakdown` to the response with the `200` status - removed `subschema #1, subschema #2` from the `results/items/attachments/items/` response property `anyOf` list for the response status `200` - **2025-10-15** `b366d059d1ae`: 7 breaking, 4 warning, 15 info - removed the enum value `-page_views__30` from the property `allOf[subschema #1: Ordering]/` of the `query` request parameter `ordering` - removed the enum value `-page_views__7` from the property `allOf[subschema #1: Ordering]/` of the `query` request parameter `ordering` - removed the enum value `-page_views__lifetime` from the property `allOf[subschema #1: Ordering]/` of the `query` request parameter `ordering` - removed the enum value `page_views__30` from the property `allOf[subschema #1: Ordering]/` of the `query` request parameter `ordering` - removed the enum value `page_views__7` from the property `allOf[subschema #1: Ordering]/` of the `query` request parameter `ordering` - removed the enum value `page_views__lifetime` from the property `allOf[subschema #1: Ordering]/` of the `query` request parameter `ordering` - the `results/items/attachments/items/` response's property type changed from `string` to no type, and format from `uuid` to no format for status `200` - removed the optional property `results/items/analytics/page_views__30` from the response with the `200` status - removed the optional property `results/items/analytics/page_views__7` from the response with the `200` status - removed the optional property `results/items/analytics/page_views__lifetime` from the response with the `200` status - added the new `suppressed` enum value to the `results/items/status/allOf[subschema #1: Status]/` response property for the response status `200` - added the enum value `-page_views_30` to the property `allOf[subschema #1: Ordering]/` of the `query` request parameter `ordering` - added the enum value `-page_views_7` to the property `allOf[subschema #1: Ordering]/` of the `query` request parameter `ordering` - added the enum value `-page_views_lifetime` to the property `allOf[subschema #1: Ordering]/` of the `query` request parameter `ordering` - added the enum value `page_views_30` to the property `allOf[subschema #1: Ordering]/` of the `query` request parameter `ordering` - added the enum value `page_views_7` to the property `allOf[subschema #1: Ordering]/` of the `query` request parameter `ordering` - added the enum value `page_views_lifetime` to the property `allOf[subschema #1: Ordering]/` of the `query` request parameter `ordering` - added the enum value `suppressed` to the property `items/` of the `query` request parameter `negative_status` - added the enum value `suppressed` to the property `items/` of the `query` request parameter `status` - added the optional property `results/items/analytics/page_views_30` to the response with the `200` status - added the optional property `results/items/analytics/page_views_7` to the response with the `200` status - added the optional property `results/items/analytics/page_views_lifetime` to the response with the `200` status - added the optional property `results/items/suppression_reason` to the response with the `200` status - added `subschema #1, subschema #2` to the `results/items/attachments/items/` response property `anyOf` list for the response status `200` - removed the `airy` enum value from the `results/items/template/allOf[subschema #1: EmailTemplate]/` response property for the response status `200` - added the required property `results/items/should_trigger_pay_per_email_billing` to the response with the `200` status - **2025-07-11** `b3fb230c0938`: 9 breaking, 32 info - for the `query` request parameter `status`, default value `about_to_send, in_flight, sent` was removed - added the pattern `^\d{4}-\d{2}-\d{2}$` to the `query` request parameter `creation_date__end` - added the pattern `^\d{4}-\d{2}-\d{2}$` to the `query` request parameter `creation_date__start` - added the pattern `^\d{4}-\d{2}-\d{2}$` to the `query` request parameter `publish_date__end` - added the pattern `^\d{4}-\d{2}-\d{2}$` to the `query` request parameter `publish_date__start` - removed the enum value `hidden` from the property `items/` of the `query` request parameter `email_type` - the `results/items/source` response's property type changed from `string` to no type for status `200` - the `results/items/status` response's property type changed from `string` to no type for status `200` - the `results/items/template` response's property type changed from `string` to no type for status `200` - added the new optional `query` request parameter `negative_status` - added the enum value `-complaint_rate` to the property `allOf[subschema #1: Ordering]/` of the `query` request parameter `ordering` - added the enum value `-permanent_failure_rate` to the property `allOf[subschema #1: Ordering]/` of the `query` request parameter `ordering` - added the enum value `complaint_rate` to the property `allOf[subschema #1: Ordering]/` of the `query` request parameter `ordering` - added the enum value `permanent_failure_rate` to the property `allOf[subschema #1: Ordering]/` of the `query` request parameter `ordering` - added the enum value `resending` to the property `items/` of the `query` request parameter `status` - added the enum value `throttled` to the property `items/` of the `query` request parameter `status` - added the enum value `transactional` to the property `items/` of the `query` request parameter `status` - added `#/components/schemas/EmailSource` to the `results/items/source` response property `allOf` list for the response status `200` - added `#/components/schemas/EmailStatus` to the `results/items/status` response property `allOf` list for the response status `200` - added `#/components/schemas/NewsletterEmailTemplate` to the `results/items/template` response property `allOf` list for the response status `200` - removed the `about_to_send` enum value from the `results/items/status` response property for the response status `200` - removed the `airy` enum value from the `results/items/template` response property for the response status `200` - removed the `api` enum value from the `results/items/source` response property for the response status `200` - removed the `app` enum value from the `results/items/source` response property for the response status `200` - removed the `classic` enum value from the `results/items/template` response property for the response status `200` - removed the `deleted` enum value from the `results/items/status` response property for the response status `200` - removed the `draft` enum value from the `results/items/status` response property for the response status `200` - removed the `errored` enum value from the `results/items/status` response property for the response status `200` - removed the `external_feed` enum value from the `results/items/source` response property for the response status `200` - removed the `hidden` enum value from the `results/items/email_type/allOf[subschema #1: Type]/` response property for the response status `200` - removed the `import` enum value from the `results/items/source` response property for the response status `200` - removed the `imported` enum value from the `results/items/status` response property for the response status `200` - removed the `in_flight` enum value from the `results/items/status` response property for the response status `200` - removed the `managed_by_rss` enum value from the `results/items/status` response property for the response status `200` - removed the `modern` enum value from the `results/items/template` response property for the response status `200` - removed the `naked` enum value from the `results/items/template` response property for the response status `200` - removed the `paused` enum value from the `results/items/status` response property for the response status `200` - removed the `plaintext` enum value from the `results/items/template` response property for the response status `200` - removed the `scheduled` enum value from the `results/items/status` response property for the response status `200` - removed the `sent` enum value from the `results/items/status` response property for the response status `200` - …1 more - **2025-03-24** `b318723a4d8d`: 3 breaking, 10 info - for the `query` request parameter `email_type`, default value `` was removed - the response property `results/items/email_type` became optional for the status `200` - the `results/items/email_type` response's property type changed from `string` to no type for status `200` - added `#/components/schemas/EmailType` to the `results/items/email_type` response property `allOf` list for the response status `200` - the `email_type` response's property default value `public` was added for the status `200` - removed the `archival` enum value from the `results/items/email_type` response property for the response status `200` - removed the `churned` enum value from the `results/items/email_type` response property for the response status `200` - removed the `free` enum value from the `results/items/email_type` response property for the response status `200` - removed the `hidden` enum value from the `results/items/email_type` response property for the response status `200` - removed the `modern-german` enum value from the `results/items/template` response property for the response status `200` - removed the `premium` enum value from the `results/items/email_type` response property for the response status `200` - removed the `private` enum value from the `results/items/email_type` response property for the response status `200` - removed the `public` enum value from the `results/items/email_type` response property for the response status `200` - **2025-02-18** `7b086652e3cf`: 4 breaking, 8 info - for the `query` request parameter `ids`, default value `` was removed - removed the required property `results/items/custom_teaser` from the response with the `200` status - removed the required property `results/items/is_comments_disabled` from the response with the `200` status - removed the required property `results/items/should_send_teaser` from the response with the `200` status - the endpoint scheme security `PermissionAuthenticationRequirement` was added to the API - the endpoint scheme security `AuthenticationRequirement` was removed from the API - added the new optional `query` request parameter `subject` - added the enum value `-social_mentions` to the property `allOf[subschema #1: Ordering]/` of the `query` request parameter `ordering` - added the enum value `social_mentions` to the property `allOf[subschema #1: Ordering]/` of the `query` request parameter `ordering` - added the optional property `results/items/analytics/social_mentions` to the response with the `200` status - added the required property `results/items/commenting_mode` to the response with the `200` status - added the required property `results/items/related_email_ids` to the response with the `200` status --- [Operation](https://skmtc.dev/buttondown/apis/buttondown-api/docs/emails/get.md) - [API](https://skmtc.dev/buttondown/apis/buttondown-api.md) - [Page](https://skmtc.dev/buttondown/apis/buttondown-api/changes/emails/get)