---
title: "Changes to List boards"
method: GET
path: "/boards"
---

# Changes to List boards

`GET /boards`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 8 of 29 revisions.

- **2025-10-16** (v5) `14c297539b64` — 1 breaking, 8 info
- **2025-07-16** (v5) `43134ca41f18` — 1 info
- **2024-08-14** (v5) `89c27ed39cfd` — 1 info
- **2024-04-23** (v5) `f9321315766f` — 1 breaking
- **2024-02-08** (v5) `7529b464d5cb` — 2 info
- **2023-05-12** (v5) `689b4b267639` — 7 info
- **2022-11-14** (v5) `e041d7b0cef0` — 1 info
- **2021-11-05** (v5) `8583f6373a80` — 1 breaking

## Changes

- **2025-10-16** (v5) `14c297539b64` — 1 breaking, 8 info
  - the response's body type/format changed from ``/`` to `object`/`` for status `200`
  - 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 `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` — 1 info
  - added the optional property `allOf[subschema #2]/items/items/is_ads_only` to the response with the `200` status
- **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/format changed from ``/`` to `object`/`` for status `200`
- **2024-02-08** (v5) `7529b464d5cb` — 2 info
  - added the new enum value `ALL` to the `query` request parameter `privacy`
  - added the new enum value `PUBLIC_AND_SECRET` to the `query` request parameter `privacy`
- **2023-05-12** (v5) `689b4b267639` — 7 info
  - added the new optional `query` request parameter `ad_account_id`
  - added the optional property `allOf[subschema #2]/items/items/board_pins_modified_at` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/items/items/collaborator_count` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/items/items/created_at` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/items/items/follower_count` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/items/items/media` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/items/items/pin_count` to the response with the `200` status
- **2022-11-14** (v5) `e041d7b0cef0` — 1 info
  - for the `query` request parameter `page_size`, the max was increased from `100.00` to `250.00`
- **2021-11-05** (v5) `8583f6373a80` — 1 breaking
  - the `allOf[subschema #2]/items/items/owner` response's property type/format changed from ``/`` to `object`/`` for status `200`

---

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