--- title: "Changes to List Newsletters" method: GET path: "/newsletters" --- # Changes to List Newsletters `GET /newsletters` > Every recorded change to this operation, newest first. ## Timeline Changed in 9 of 43 revisions. - **2026-09-19** `04d1f70af68b`: 1 warning - **2026-09-07** `9e6846726e66`: 2 warning - **2026-07-26** `fc5d382abadb`: 11 warning, 2 info - **2026-07-13** `228cc05ba97d`: 16 warning, 2 info - **2026-06-07** `13f3bc084194`: 9 breaking, 1 warning, 42 info - **2026-01-17** `8590daeecaea`: 5 info - **2025-10-15** `b366d059d1ae`: 4 info - **2025-07-11** `b3fb230c0938`: 4 info - **2025-02-18** `7b086652e3cf`: 2 info ## Changes - **2026-09-19** `04d1f70af68b`: 1 warning - removed the optional property `results/items/custom_gift_subscription_email_template` from the response with the `200` status - **2026-09-07** `9e6846726e66`: 2 warning - removed the optional property `results/items/custom_expired_trial_notification_template` from the response with the `200` status - removed the optional property `results/items/email_theme_configuration` from the response with the `200` status - **2026-07-26** `fc5d382abadb`: 11 warning, 2 info - added the new `ao3` enum value to the `results/items/socials/items/type` response property for the response status `200` - added the new `arena` enum value to the `results/items/socials/items/type` response property for the response status `200` - added the new `bandcamp` enum value to the `results/items/socials/items/type` response property for the response status `200` - added the new `behance` enum value to the `results/items/socials/items/type` response property for the response status `200` - added the new `etsy` enum value to the `results/items/socials/items/type` response property for the response status `200` - added the new `gumroad` enum value to the `results/items/socials/items/type` response property for the response status `200` - added the new `it` enum value to the `results/items/locale/allOf[subschema #1: Locale]/` response property for the response status `200` - added the new `itchio` enum value to the `results/items/socials/items/type` response property for the response status `200` - added the new `medium` enum value to the `results/items/socials/items/type` response property for the response status `200` - added the new `steam` enum value to the `results/items/socials/items/type` response property for the response status `200` - added the new `vimeo` enum value to the `results/items/socials/items/type` response property for the response status `200` - added the optional property `results/items/hosting_domain_status` to the response with the `200` status - added the optional property `results/items/sending_domain_status` to the response with the `200` status - **2026-07-13** `228cc05ba97d`: 16 warning, 2 info - added the new `custom` enum value to the `results/items/custom_churn_email_template/anyOf[subschema #1: EmailTemplate]/` response property for the response status `200` - added the new `custom` enum value to the `results/items/custom_expired_trial_notification_template/anyOf[subschema #1: EmailTemplate]/` response property for the response status `200` - added the new `custom` enum value to the `results/items/custom_gift_subscription_email_template/anyOf[subschema #1: EmailTemplate]/` response property for the response status `200` - added the new `custom` enum value to the `results/items/custom_gift_unsubscription_email_template/anyOf[subschema #1: EmailTemplate]/` response property for the response status `200` - added the new `custom` enum value to the `results/items/custom_premium_confirmation_email_template/anyOf[subschema #1: EmailTemplate]/` response property for the response status `200` - added the new `custom` enum value to the `results/items/custom_subscription_confirmation_email_template/anyOf[subschema #1: EmailTemplate]/` response property for the response status `200` - added the new `custom` enum value to the `results/items/template/allOf[subschema #1: EmailTemplate]/` response property for the response status `200` - added the new `discord` enum value to the `results/items/socials/items/type` response property for the response status `200` - added the new `fi-FI` enum value to the `results/items/locale/allOf[subschema #1: Locale]/` response property for the response status `200` - added the new `ja-JP` enum value to the `results/items/locale/allOf[subschema #1: Locale]/` response property for the response status `200` - added the new `reddit` enum value to the `results/items/socials/items/type` response property for the response status `200` - added the new `soundcloud` enum value to the `results/items/socials/items/type` response property for the response status `200` - added the new `spotify` enum value to the `results/items/socials/items/type` response property for the response status `200` - added the new `substack` enum value to the `results/items/socials/items/type` response property for the response status `200` - added the new `telegram` enum value to the `results/items/socials/items/type` response property for the response status `200` - added the new `tumblr` enum value to the `results/items/socials/items/type` response property for the response status `200` - added the new optional `query` request parameter `page` - added the non-success response with the status `429` - **2026-06-07** `13f3bc084194`: 9 breaking, 1 warning, 42 info - 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/custom_email_template` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `results/items/icon` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `results/items/image` 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 `400` - the `code` response's property type changed from no type to `string` for status `403` - the `results/items/custom_churn_email_template` response's property type changed from `string` to no type for status `200` - the `results/items/id` response's property format changed from `uuid` to no format for status `200` - removed the optional property `results/items/css_tokens` from the response with the `200` status - the endpoint scheme security `ApiKeyAuth` was added to the API - the endpoint scheme security `PermissionAuthenticationRequirement` was removed from the API - api tag `Newsletters` added - added the non-success response with the status `401` - added the optional property `results/items/announcement_bar_background_color` to the response with the `200` status - added the optional property `results/items/announcement_bar_text` to the response with the `200` status - added the optional property `results/items/announcement_bar_visibility` to the response with the `200` status - added the optional property `results/items/archive_theme` to the response with the `200` status - added the optional property `results/items/custom_expired_trial_notification_body` to the response with the `200` status - added the optional property `results/items/custom_expired_trial_notification_subject` to the response with the `200` status - added the optional property `results/items/custom_expired_trial_notification_template` to the response with the `200` status - added the optional property `results/items/custom_gift_subscription_email_body` to the response with the `200` status - added the optional property `results/items/custom_gift_subscription_email_subject` to the response with the `200` status - added the optional property `results/items/custom_gift_subscription_email_template` to the response with the `200` status - added the optional property `results/items/custom_gift_unsubscription_email_body` to the response with the `200` status - added the optional property `results/items/custom_gift_unsubscription_email_subject` to the response with the `200` status - added the optional property `results/items/custom_gift_unsubscription_email_template` to the response with the `200` status - added the optional property `results/items/custom_premium_confirmation_email_body` to the response with the `200` status - added the optional property `results/items/custom_premium_confirmation_email_subject` to the response with the `200` status - added the optional property `results/items/custom_premium_confirmation_email_template` to the response with the `200` status - added the optional property `results/items/custom_subscription_confirmation_email_subject` to the response with the `200` status - added the optional property `results/items/custom_subscription_confirmation_email_template` to the response with the `200` status - added the optional property `results/items/custom_subscription_confirmation_email_text` to the response with the `200` status - added the optional property `results/items/custom_subscription_confirmation_reminder_email_subject` to the response with the `200` status - added the optional property `results/items/custom_subscription_confirmation_reminder_email_text` to the response with the `200` status - added the optional property `results/items/custom_subscription_confirmed_email_subject` to the response with the `200` status - added the optional property `results/items/custom_subscription_confirmed_email_text` to the response with the `200` status - added the optional property `results/items/email_theme_configuration` to the response with the `200` status - added the optional property `results/items/icon_alt_text` to the response with the `200` status - added the optional property `results/items/locale` to the response with the `200` status - …12 more - **2026-01-17** `8590daeecaea`: 5 info - added the optional property `results/items/css_tokens` to the response with the `200` status - added the optional property `results/items/email_address` to the response with the `200` status - added the optional property `results/items/metadata` to the response with the `200` status - added the optional property `results/items/sort` to the response with the `200` status - added the optional property `results/items/test_mode` to the response with the `200` status - **2025-10-15** `b366d059d1ae`: 4 info - added the optional property `results/items/auditing_mode` to the response with the `200` status - added the optional property `results/items/custom_churn_email_body` to the response with the `200` status - added the optional property `results/items/custom_churn_email_subject` to the response with the `200` status - added the optional property `results/items/custom_churn_email_template` to the response with the `200` status - **2025-07-11** `b3fb230c0938`: 4 info - added the optional property `results/items/css` to the response with the `200` status - added the optional property `results/items/icon` to the response with the `200` status - added the optional property `results/items/image` to the response with the `200` status - added the optional property `results/items/web_css` to the response with the `200` status - **2025-02-18** `7b086652e3cf`: 2 info - the endpoint scheme security `PermissionAuthenticationRequirement` was added to the API - the endpoint scheme security `AuthenticationRequirement` was removed from the API --- [Operation](https://skmtc.dev/buttondown/apis/buttondown-api/docs/newsletters/get.md) - [API](https://skmtc.dev/buttondown/apis/buttondown-api.md) - [Page](https://skmtc.dev/buttondown/apis/buttondown-api/changes/newsletters/get)