--- title: "Changes to List Pins" method: GET path: "/pins" --- # Changes to List Pins `GET /pins` > Every recorded change to this operation, newest first. ## Timeline Changed in 12 of 29 revisions. - **2026-06-04** (v5) `b698c180678a`: 1 breaking, 12 warning, 5 info - **2025-10-16** (v5) `14c297539b64`: 4 warning, 3 info - **2025-08-14** (v5) `7d64d863909a`: 1 breaking, 9 info - **2025-07-16** (v5) `43134ca41f18`: 2 info - **2025-04-04** (v5) `10f9eba4ad97`: 1 warning, 3 info - **2024-08-14** (v5) `89c27ed39cfd`: 1 info - **2024-04-23** (v5) `f9321315766f`: 1 breaking - **2024-02-08** (v5) `7529b464d5cb`: 2 info - **2023-08-17** (v5) `0ff12596bafd`: 2 info - **2023-07-14** (v5) `52586a274771`: 2 breaking, 11 info - **2023-05-12** (v5) `689b4b267639`: 6 info - **2023-02-14** (v5) `be19b77aa78a`: 1 info ## Changes - **2026-06-04** (v5) `b698c180678a`: 1 breaking, 12 warning, 5 info - removed the required property `items/items/id` from the response with the `200` status - removed the optional property `items/items/board_id` from the response with the `200` status - removed the optional property `items/items/board_owner` from the response with the `200` status - removed the optional property `items/items/board_section_id` from the response with the `200` status - removed the optional property `items/items/created_at` from the response with the `200` status - removed the optional property `items/items/creative_type` from the response with the `200` status - removed the optional property `items/items/dominant_color` from the response with the `200` status - removed the optional property `items/items/has_been_promoted` from the response with the `200` status - removed the optional property `items/items/is_owner` from the response with the `200` status - removed the optional property `items/items/is_standard` from the response with the `200` status - removed the optional property `items/items/media` from the response with the `200` status - removed the optional property `items/items/parent_pin_id` from the response with the `200` status - removed the optional property `items/items/pin_metrics` from the response with the `200` status - added the new optional `query` request parameter `domain` - added the new optional `query` request parameter `domains` - added the new optional `query` request parameter `include_product_tag_obj` - added the enum value `APP` to the property `items/` of the `query` request parameter `creative_types` - added `#/components/schemas/PinBase` to the `items/items/` response property `allOf` list for the response status `200` - **2025-10-16** (v5) `14c297539b64`: 4 warning, 3 info - removed the optional property `items/items/note` from the response with the `200` status - added the new `COLLAGE` enum value to the `items/items/creative_type/allOf[subschema #1: CreativeType enum used ads]/` response property for the response status `200` - added the new `MAX_WIDTH_REGULAR_COLLECTION` enum value to the `items/items/creative_type/allOf[subschema #1: CreativeType enum used ads]/` response property for the response status `200` - added the new `MAX_WIDTH_VIDEO_COLLECTION` enum value to the `items/items/creative_type/allOf[subschema #1: CreativeType enum used ads]/` response property for the response status `200` - added the enum value `COLLAGE` to the property `items/` of the `query` request parameter `creative_types` - added the enum value `MAX_WIDTH_REGULAR_COLLECTION` to the property `items/` of the `query` request parameter `creative_types` - added the enum value `MAX_WIDTH_VIDEO_COLLECTION` to the property `items/` of the `query` request parameter `creative_types` - **2025-08-14** (v5) `7d64d863909a`: 1 breaking, 9 info - the response's body type changed from no type to `object` for status `200` - added the enum value `QUIZ` to the property `items/` of the `query` request parameter `creative_types` - added the enum value `SHOWCASE` to the property `items/` of the `query` request parameter `creative_types` - removed `#/components/schemas/Paginated, subschema #2` from the response body `allOf` list for the response status `200` - added the non-success response with the status `401` - added the non-success response with the status `403` - added the non-success response with the status `404` - added the non-success response with the status `429` - added the optional property `bookmark` to the response with the `200` status - added the required property `items` to the response with the `200` status - **2025-07-16** (v5) `43134ca41f18`: 2 info - added the optional property `allOf[subschema #2]/items/items/is_removable` to the response with the `200` status - added the optional property `allOf[subschema #2]/items/items/product_tags` to the response with the `200` status - **2025-04-04** (v5) `10f9eba4ad97`: 1 warning, 3 info - removed the optional property `allOf[subschema #2]/items/items/media/allOf[subschema #1: Pin media]/media_type` from the response with the `200` status - added the optional property `allOf[subschema #2]/items/items/media_source/allOf[subschema #1: Pin media source]/oneOf[subschema #3: Video ID]/cover_image_key_frame_time` to the response with the `200` status - added `#/components/schemas/PinMediaBase, subschema #2` to the `allOf[subschema #2]/items/items/media/allOf[subschema #1: Pin media]/` response property `allOf` list for the response status `200` - removed discriminator from `allOf[subschema #2]/items/items/media/allOf[subschema #1: Pin media]/` response property for the response status `200` - **2024-08-14** (v5) `89c27ed39cfd`: 1 info - the endpoint scheme security `client_credentials` was added to the API - **2024-04-23** (v5) `f9321315766f`: 1 breaking - the `allOf[subschema #2]/` response's property type changed from no type to `object` for status `200` - **2024-02-08** (v5) `7529b464d5cb`: 2 info - added the new optional `query` request parameter `pin_metrics` - added the optional property `allOf[subschema #2]/items/items/pin_metrics` to the response with the `200` status - **2023-08-17** (v5) `0ff12596bafd`: 2 info - added the new optional `query` request parameter `page_size` - added the optional property `allOf[subschema #2]/items/items/media_source/allOf[subschema #1: Pin media source]/oneOf[subschema #6: Pin URL]/is_affiliate_link` to the response with the `200` status - **2023-07-14** (v5) `52586a274771`: 2 breaking, 11 info - the response property `allOf[subschema #2]/items/items/media_source/allOf[subschema #1: Pin media source]/oneOf[subschema #3: Video ID]/cover_image_url` became optional for the status `200` - added `#/components/schemas/PinMediaSourcePinURL` to the `allOf[subschema #2]/items/items/media_source/allOf[subschema #1: Pin media source]/` response property `oneOf` list for the response status `200` - added the new enum value `has_been_promoted` to the `query` request parameter `pin_filter` - added the enum value `COLLECTION` to the property `items/` of the `query` request parameter `creative_types` - added the optional property `allOf[subschema #2]/items/items/has_been_promoted` to the response with the `200` status - added the optional property `allOf[subschema #2]/items/items/is_owner` to the response with the `200` status - added the optional property `allOf[subschema #2]/items/items/is_standard` to the response with the `200` status - added the optional property `allOf[subschema #2]/items/items/media_source/allOf[subschema #1: Pin media source]/oneOf[subschema #3: Video ID]/cover_image_content_type` to the response with the `200` status - added the optional property `allOf[subschema #2]/items/items/media_source/allOf[subschema #1: Pin media source]/oneOf[subschema #3: Video ID]/cover_image_data` to the response with the `200` status - added the optional property `allOf[subschema #2]/items/items/note` to the response with the `200` status - added `#/components/schemas/CreativeType` to the `allOf[subschema #2]/items/items/creative_type` response property `allOf` list for the response status `200` - removed `subschema #1: Creative Type` from the `allOf[subschema #2]/items/items/creative_type` response property `allOf` list for the response status `200` - added `pin_url` discriminator mapping keys to the `allOf[subschema #2]/items/items/media_source/allOf[subschema #1: Pin media source]/` response property for the response status `200` - **2023-05-12** (v5) `689b4b267639`: 6 info - added the new optional `query` request parameter `ad_account_id` - added the new optional `query` request parameter `creative_types` - added the optional property `allOf[subschema #2]/items/items/creative_type` to the response with the `200` status - added the optional property `allOf[subschema #2]/items/items/media_source/allOf[subschema #1: Pin media source]/oneOf[subschema #1: Image Base64]/is_standard` to the response with the `200` status - added the optional property `allOf[subschema #2]/items/items/media_source/allOf[subschema #1: Pin media source]/oneOf[subschema #2: Image URL]/is_standard` to the response with the `200` status - added the optional property `allOf[subschema #2]/items/items/media_source/allOf[subschema #1: Pin media source]/oneOf[subschema #3: Video ID]/is_standard` to the response with the `200` status - **2023-02-14** (v5) `be19b77aa78a`: 1 info - endpoint added --- [Operation](https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/pins/get.md) - [API](https://skmtc.dev/pinterest/apis/pinterest-rest-api.md) - [Page](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/pins/get)