--- title: "Changes to Retrieve Items" method: GET path: "/external_feeds/{id}/items" --- # Changes to Retrieve Items `GET /external_feeds/{id}/items` > Every recorded change to this operation, newest first. ## Timeline Changed in 12 of 43 revisions. - **2026-10-27** `8fff9c6b1347`: 1 warning, 1 info - **2026-10-20** `bc6be78752aa`: 1 info - **2026-09-22** `f00fce908264`: 1 warning - **2026-08-08** `3a702c095d22`: 1 warning - **2026-07-26** `fc5d382abadb`: 1 warning - **2026-07-13** `228cc05ba97d`: 1 warning, 3 info - **2026-06-07** `13f3bc084194`: 24 breaking, 9 warning, 5 info - **2026-01-17** `8590daeecaea`: 4 breaking, 5 info - **2025-10-15** `b366d059d1ae`: 1 breaking, 4 warning, 7 info - **2025-07-11** `b3fb230c0938`: 3 breaking, 24 info - **2025-03-24** `b318723a4d8d`: 2 breaking, 10 info - **2025-02-18** `7b086652e3cf`: 3 breaking, 5 info ## Changes - **2026-10-27** `8fff9c6b1347`: 1 warning, 1 info - removed the optional property `results/items/email/anyOf[subschema #1: Email]/suppression_reason` from the response with the `200` status - removed the `suppressed` enum value from the `results/items/email/anyOf[subschema #1: Email]/status` response property for the response status `200` - **2026-10-20** `bc6be78752aa`: 1 info - added the optional property `results/items/email/anyOf[subschema #1: Email]/analytics/anyOf[subschema #1: Analytics]/attempts` to the response with the `200` status - **2026-09-22** `f00fce908264`: 1 warning - added the new `partially_sent` enum value to the `results/items/email/anyOf[subschema #1: Email]/status` response property for the response status `200` - **2026-08-08** `3a702c095d22`: 1 warning - added the new `archive_only` enum value to the `results/items/email/anyOf[subschema #1: Email]/archival_mode` response property for the response status `200` - **2026-07-26** `fc5d382abadb`: 1 warning - added the new `smtp` enum value to the `results/items/email/anyOf[subschema #1: Email]/source` response property for the response status `200` - **2026-07-13** `228cc05ba97d`: 1 warning, 3 info - added the new `custom` enum value to the `results/items/email/anyOf[subschema #1: Email]/template/anyOf[subschema #1: EmailTemplate]/` response property for the response status `200` - added the new optional `query` request parameter `page` - added the non-success response with the status `422` - added the non-success response with the status `429` - **2026-06-07** `13f3bc084194`: 24 breaking, 9 warning, 5 info - removed the enum value `email` from the property `items/` of the `query` request parameter `expand` - 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/email_id` 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 `code` response's property type changed from no type to `string` for status `404` - the `results/items/email` response's property type changed from `object` to no type for status `200` - removed the required property `results/items/email/absolute_url` from the response with the `200` status - removed the required property `results/items/email/body` from the response with the `200` status - removed the required property `results/items/email/canonical_url` from the response with the `200` status - removed the required property `results/items/email/commenting_mode` from the response with the `200` status - removed the required property `results/items/email/creation_date` from the response with the `200` status - removed the required property `results/items/email/description` from the response with the `200` status - removed the required property `results/items/email/featured` from the response with the `200` status - removed the required property `results/items/email/filters` from the response with the `200` status - removed the required property `results/items/email/id` from the response with the `200` status - removed the required property `results/items/email/image` from the response with the `200` status - removed the required property `results/items/email/modification_date` from the response with the `200` status - removed the required property `results/items/email/related_email_ids` from the response with the `200` status - removed the required property `results/items/email/should_trigger_pay_per_email_billing` from the response with the `200` status - removed the required property `results/items/email/source` from the response with the `200` status - removed the required property `results/items/email/status` from the response with the `200` status - removed the required property `results/items/email/subject` from the response with the `200` status - removed the optional property `results/items/email/analytics` from the response with the `200` status - removed the optional property `results/items/email/attachments` from the response with the `200` status - removed the optional property `results/items/email/email_type` from the response with the `200` status - removed the optional property `results/items/email/metadata` from the response with the `200` status - removed the optional property `results/items/email/publish_date` from the response with the `200` status - removed the optional property `results/items/email/secondary_id` from the response with the `200` status - removed the optional property `results/items/email/slug` from the response with the `200` status - removed the optional property `results/items/email/suppression_reason` from the response with the `200` status - removed the optional property `results/items/email/template` 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 `External Feeds` added - added the non-success response with the status `401` - added `#/components/schemas/Email, subschema #2` to the `results/items/email` response property `anyOf` list for the response status `200` - **2026-01-17** `8590daeecaea`: 4 breaking, 5 info - the `results/items/email/attachments/items/` response's property type changed from no type to `string` for status `200` - the `results/items/email/id` response's property format changed from `uuid` to no format for status `200` - the `results/items/email_id` response's property format changed from `uuid` to no format for status `200` - the `results/items/id` response's property format changed from `uuid` to no format for status `200` - for the `path` request parameter `id`, the format was generalized from `uuid` to no format - added the non-success response with the status `400` - added the optional property `results/items/email/analytics/permanent_failure_breakdown` to the response with the `200` status - added the optional property `results/items/email/analytics/temporary_failure_breakdown` to the response with the `200` status - removed `subschema #1, subschema #2` from the `results/items/email/attachments/items/` response property `anyOf` list for the response status `200` - **2025-10-15** `b366d059d1ae`: 1 breaking, 4 warning, 7 info - the `results/items/email/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/email/analytics/page_views__30` from the response with the `200` status - removed the optional property `results/items/email/analytics/page_views__7` from the response with the `200` status - removed the optional property `results/items/email/analytics/page_views__lifetime` from the response with the `200` status - added the new `suppressed` enum value to the `results/items/email/status/allOf[subschema #1: Status]/` response property for the response status `200` - added the optional property `results/items/email/analytics/page_views_30` to the response with the `200` status - added the optional property `results/items/email/analytics/page_views_7` to the response with the `200` status - added the optional property `results/items/email/analytics/page_views_lifetime` to the response with the `200` status - added the optional property `results/items/email/suppression_reason` to the response with the `200` status - added `subschema #1, subschema #2` to the `results/items/email/attachments/items/` response property `anyOf` list for the response status `200` - removed the `airy` enum value from the `results/items/email/template/allOf[subschema #1: EmailTemplate]/` response property for the response status `200` - added the required property `results/items/email/should_trigger_pay_per_email_billing` to the response with the `200` status - **2025-07-11** `b3fb230c0938`: 3 breaking, 24 info - the `results/items/email/source` response's property type changed from `string` to no type for status `200` - the `results/items/email/status` response's property type changed from `string` to no type for status `200` - the `results/items/email/template` response's property type changed from `string` to no type for status `200` - added `#/components/schemas/EmailSource` to the `results/items/email/source` response property `allOf` list for the response status `200` - added `#/components/schemas/EmailStatus` to the `results/items/email/status` response property `allOf` list for the response status `200` - added `#/components/schemas/NewsletterEmailTemplate` to the `results/items/email/template` response property `allOf` list for the response status `200` - removed the `about_to_send` enum value from the `results/items/email/status` response property for the response status `200` - removed the `airy` enum value from the `results/items/email/template` response property for the response status `200` - removed the `api` enum value from the `results/items/email/source` response property for the response status `200` - removed the `app` enum value from the `results/items/email/source` response property for the response status `200` - removed the `classic` enum value from the `results/items/email/template` response property for the response status `200` - removed the `deleted` enum value from the `results/items/email/status` response property for the response status `200` - removed the `draft` enum value from the `results/items/email/status` response property for the response status `200` - removed the `errored` enum value from the `results/items/email/status` response property for the response status `200` - removed the `external_feed` enum value from the `results/items/email/source` response property for the response status `200` - removed the `hidden` enum value from the `results/items/email/email_type/allOf[subschema #1: Type]/` response property for the response status `200` - removed the `import` enum value from the `results/items/email/source` response property for the response status `200` - removed the `imported` enum value from the `results/items/email/status` response property for the response status `200` - removed the `in_flight` enum value from the `results/items/email/status` response property for the response status `200` - removed the `managed_by_rss` enum value from the `results/items/email/status` response property for the response status `200` - removed the `modern` enum value from the `results/items/email/template` response property for the response status `200` - removed the `naked` enum value from the `results/items/email/template` response property for the response status `200` - removed the `paused` enum value from the `results/items/email/status` response property for the response status `200` - removed the `plaintext` enum value from the `results/items/email/template` response property for the response status `200` - removed the `scheduled` enum value from the `results/items/email/status` response property for the response status `200` - removed the `sent` enum value from the `results/items/email/status` response property for the response status `200` - added the required property `results/items/email/featured` to the response with the `200` status - **2025-03-24** `b318723a4d8d`: 2 breaking, 10 info - the response property `results/items/email/email_type` became optional for the status `200` - the `results/items/email/email_type` response's property type changed from `string` to no type for status `200` - added `#/components/schemas/EmailType` to the `results/items/email/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/email_type` response property for the response status `200` - removed the `churned` enum value from the `results/items/email/email_type` response property for the response status `200` - removed the `free` enum value from the `results/items/email/email_type` response property for the response status `200` - removed the `hidden` enum value from the `results/items/email/email_type` response property for the response status `200` - removed the `modern-german` enum value from the `results/items/email/template` response property for the response status `200` - removed the `premium` enum value from the `results/items/email/email_type` response property for the response status `200` - removed the `private` enum value from the `results/items/email/email_type` response property for the response status `200` - removed the `public` enum value from the `results/items/email/email_type` response property for the response status `200` - **2025-02-18** `7b086652e3cf`: 3 breaking, 5 info - removed the required property `results/items/email/custom_teaser` from the response with the `200` status - removed the required property `results/items/email/is_comments_disabled` from the response with the `200` status - removed the required property `results/items/email/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 optional property `results/items/email/analytics/social_mentions` to the response with the `200` status - added the required property `results/items/email/commenting_mode` to the response with the `200` status - added the required property `results/items/email/related_email_ids` to the response with the `200` status --- [Operation](https://skmtc.dev/buttondown/apis/buttondown-api/docs/external_feeds/:id/items/get.md) - [API](https://skmtc.dev/buttondown/apis/buttondown-api.md) - [Page](https://skmtc.dev/buttondown/apis/buttondown-api/changes/external_feeds/:id/items/get)