---
title: "Changes to List Pins on board"
method: GET
path: "/boards/{board_id}/pins"
---

# Changes to List Pins on board

`GET /boards/{board_id}/pins`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 21 of 29 revisions.

- **2026-06-04** (v5) `b698c180678a` — 1 breaking, 8 info
- **2025-12-11** (v5) `79f62f71f05b` — 5 info
- **2025-10-16** (v5) `14c297539b64` — 4 warning
- **2025-08-14** (v5) `7d64d863909a` — 4 breaking, 2 warning, 7 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` — 1 info
- **2023-07-14** (v5) `52586a274771` — 2 breaking, 10 info
- **2023-05-12** (v5) `689b4b267639` — 6 info
- **2023-02-14** (v5) `be19b77aa78a` — 4 breaking, 2 info
- **2022-11-14** (v5) `e041d7b0cef0` — 1 breaking, 2 info
- **2022-09-07** (v5) `bd20b6eb152f` — 1 info
- **2022-07-11** (v5) `0d5998752011` — 2 info
- **2022-04-12** (v5) `723c51158044` — 2 breaking, 2 info
- **2022-04-08** (v5) `33ec8e7421c7` — 2 info
- **2022-02-09** (v5) `46313d040316` — 2 info
- **2022-01-19** (v5) `76964e873a38` — 1 info
- **2021-11-05** (v5) `8583f6373a80` — 4 breaking

## Changes

- **2026-06-04** (v5) `b698c180678a` — 1 breaking, 8 info
  - the response's body type changed from no type to `object` for status `200`
  - added the enum value `APP` 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 `400`
  - 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 `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-12-11** (v5) `79f62f71f05b` — 5 info
  - 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`
  - 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`
- **2025-10-16** (v5) `14c297539b64` — 4 warning
  - removed the optional property `allOf[subschema #2]/items/items/note` from the response with the `200` status
  - added the new `COLLAGE` enum value to the `allOf[subschema #2]/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 `allOf[subschema #2]/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 `allOf[subschema #2]/items/items/creative_type/allOf[subschema #1: CreativeType enum used ads]/` response property for the response status `200`
- **2025-08-14** (v5) `7d64d863909a` — 4 breaking, 2 warning, 7 info
  - added `#/components/schemas/PinMediaWithImage, #/components/schemas/PinMediaWithVideo, #/components/schemas/PinMediaWithImages, #/components/schemas/PinMediaWithVideos, #/components/schemas/PinMediaWithImageAndVideo` to the `allOf[subschema #2]/items/items/media/allOf[subschema #1: Pin media -> subschema #1: Pin media response object.]/` response property `oneOf` list for the response status `200`
  - the `allOf[subschema #2]/items/items/board_owner` response's property type changed from `object` to no type for status `200`
  - the `allOf[subschema #2]/items/items/creative_type` response's property type changed from `string` to no type for status `200`
  - the `allOf[subschema #2]/items/items/media` response's property type changed from `object` to no type for status `200`
  - removed the optional property `allOf[subschema #2]/items/items/is_removable` from the response with the `200` status
  - removed the optional property `allOf[subschema #2]/items/items/product_tags` from the response with the `200` status
  - the response optional property `allOf[subschema #2]/items/items/id` became not read-only for the status `200`
  - the response optional property `allOf[subschema #2]/items/items/is_standard` became read-only for the status `200`
  - the response optional property `allOf[subschema #2]/items/items/pin_metrics` became read-only for the status `200`
  - removed the optional write-only property `allOf[subschema #2]/items/items/media_source` from the response with the `200` status
  - removed `#/components/schemas/PinMediaBase, subschema #2` from the `allOf[subschema #2]/items/items/media/allOf[subschema #1: Pin media -> subschema #1: Pin media response object.]/` response property `allOf` list for the response status `200`
  - the response property `allOf[subschema #2]/items/items/id` became required for the status `200`
  - added discriminator to `allOf[subschema #2]/items/items/media/allOf[subschema #1: Pin media -> subschema #1: Pin media response object.]/` response property for the response status `200`
- **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` — 1 info
  - 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, 10 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 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` — 4 breaking, 2 info
  - the `allOf[subschema #2]/items/items/description` response property's maxLength was unset from `500` for the response status `200`
  - the `allOf[subschema #2]/items/items/title` response property's maxLength was unset from `100` for the response status `200`
  - added `#/components/schemas/PinMediaSourceImagesBase64, #/components/schemas/PinMediaSourceImagesURL` to the `allOf[subschema #2]/items/items/media_source/allOf[subschema #1: Pin media source]/` response property `oneOf` list for the response status `200`
  - the `allOf[subschema #2]/items/items/media/allOf[subschema #1: Pin media]/` response's property type changed from no type to `object` for status `200`
  - added `multiple_image_base64, multiple_image_urls` 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`
  - the `allOf[subschema #2]/items/items/id` response's property pattern `^\d+$` was added for the status `200`
- **2022-11-14** (v5) `e041d7b0cef0` — 1 breaking, 2 info
  - the response property `allOf[subschema #2]/items/items/` became nullable for the status `200`
  - for the `query` request parameter `page_size`, the max was increased from `100.00` to `250.00`
  - added `multiple_images, multiple_videos, multiple_mixed` discriminator mapping keys to the `allOf[subschema #2]/items/items/media/allOf[subschema #1: Pin media]/` response property for the response status `200`
- **2022-09-07** (v5) `bd20b6eb152f` — 1 info
  - added the optional property `allOf[subschema #2]/items/items/parent_pin_id` to the response with the `200` status
- **2022-07-11** (v5) `0d5998752011` — 2 info
  - added the optional property `allOf[subschema #2]/items/items/dominant_color` to the response with the `200` status
  - added `video` discriminator mapping keys to the `allOf[subschema #2]/items/items/media/allOf[subschema #1: Pin media]/` response property for the response status `200`
- **2022-04-12** (v5) `723c51158044` — 2 breaking, 2 info
  - added `#/components/schemas/PinMediaSourceImageBase64, #/components/schemas/PinMediaSourceImageURL, #/components/schemas/PinMediaSourceVideoID` to the `allOf[subschema #2]/items/items/media_source/allOf[subschema #1: Pin media source]/` response property `oneOf` list for the response status `200`
  - removed the required property `allOf[subschema #2]/items/items/media_source/allOf[subschema #1: Pin media source]/source_type` from the response with the `200` status
  - the `allOf[subschema #2]/items/items/board_id` response's property pattern was changed from `\d+` to `^\d+$` for the status `200`
  - the `allOf[subschema #2]/items/items/board_section_id` response's property pattern was changed from `\d+` to `^\d+$` for the status `200`
- **2022-04-08** (v5) `33ec8e7421c7` — 2 info
  - the `allOf[subschema #2]/items/items/board_id` response's property pattern was changed from `^\d+$` to `\d+` for the status `200`
  - the `allOf[subschema #2]/items/items/board_section_id` response's property pattern was changed from `^\d+$` to `\d+` for the status `200`
- **2022-02-09** (v5) `46313d040316` — 2 info
  - the `allOf[subschema #2]/items/items/board_id` response's property pattern was changed from `\d+` to `^\d+$` for the status `200`
  - the `allOf[subschema #2]/items/items/board_section_id` response's property pattern was changed from `\d+` to `^\d+$` for the status `200`
- **2022-01-19** (v5) `76964e873a38` — 1 info
  - added `video_id` 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`
- **2021-11-05** (v5) `8583f6373a80` — 4 breaking
  - added the pattern `^\d+$` to the `path` request parameter `board_id`
  - the `allOf[subschema #2]/items/items/board_owner` response's property type changed from no type to `object` for status `200`
  - the `allOf[subschema #2]/items/items/media` response's property type changed from no type to `object` for status `200`
  - the `allOf[subschema #2]/items/items/media_source` response's property type changed from no type to `object` for status `200`

---

[Operation](https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/boards/:board_id/pins/get.md) · [API](https://skmtc.dev/pinterest/apis/pinterest-rest-api.md) · [Page](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/boards/:board_id/pins/get)
