---
title: "List Pins"
method: GET
path: "/pins"
tags: ["pins"]
---

# List Pins

`GET /pins`

Get a list of the Pins owned by the "operation user_account".
- By default, the "operation user_account" is the token user_account.
- All Pins owned by the "operation user_account" are included, regardless of who owns the board they are on.
Optional: Business Access: Specify an ad_account_id to use the owner of that ad_account as the "operation user_account".

## Query parameters

- `bookmark` string
- `pin_filter` 'exclude_native' | 'exclude_repins'
- `include_protected_pins` boolean
- `pin_type` 'PRIVATE'
- `creative_types` string[]
- `ad_account_id` string

## Response `200`

Success

- object
  - `items` object[], required
    - `id` string
    - `created_at` string, date-time
    - `link` string, nullable
    - `title` string, nullable
    - `description` string, nullable
    - `dominant_color` string, nullable — Dominant pin color. Hex number, e.g. \"#6E7874\".
    - `alt_text` string, nullable
    - `creative_type` 'REGULAR' | 'VIDEO' | 'CAROUSEL' | 'MAX_VIDEO' | 'SHOP_THE_PIN' | 'IDEA', nullable — Ad creative type enum.
    - `board_id` string — The board to which this Pin belongs.
    - `board_section_id` string, nullable — The board section to which this Pin belongs.
    - `board_owner` BoardOwner
      - `username` string
    - `media` PinMedia — Pin media objects.
      - `media_type` string
    - `media_source` union — Pin media source.
      - PinMediaSourceImageBase64 — Base64-encoded image media source
        - `source_type` 'image_base64', required
        - `content_type` 'image/jpeg' | 'image/png', required
        - `data` string, required
        - `is_standard` boolean — Set the parameter to false to create the new simplified Pin instead of the standard pin. Currently the field is only available to a list of beta users.
      - PinMediaSourceImageURL — Image URL-based media source
        - `source_type` 'image_url', required
        - `url` string, required
        - `is_standard` boolean — Set the parameter to false to create the new simplified Pin instead of the standard pin. Currently the field is only available to a list of beta users.
      - PinMediaSourceVideoID — Video ID-based media source
        - `source_type` 'video_id', required
        - `cover_image_url` string, required
        - `media_id` string, required
        - `is_standard` boolean — Set the parameter to false to create the new simplified Pin instead of the standard pin. Currently the field is only available to a list of beta users.
      - PinMediaSourceImagesBase64 — Multiple Base64-encoded images media source
        - `source_type` 'multiple_image_base64'
        - `items` object[], required — Array with image objects.
          - `title` string
          - `description` string
          - `link` string — Destination link for the image.
          - `content_type` 'image/jpeg' | 'image/png', required
          - `data` string, required — Image to upload as base64 string.
        - `index` integer
      - PinMediaSourceImagesURL — Multiple images urls-based media source
        - `source_type` 'multiple_image_urls'
        - `items` object[], required — Array with image objects.
          - `title` string
          - `description` string
          - `link` string — Destination link for the image.
          - `url` string, required — URL of image to upload.
        - `index` integer
    - `parent_pin_id` string, nullable — The source pin id if this pin was saved from another pin. <a href="https://help.pinterest.com/article/save-pins-on-pinterest">Learn more</a>.
  - `bookmark` string, nullable

## Other responses

- `400` — Invalid pin filter value
- `default` — Unexpected error

## Changes

- **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
  - …2 more
- **2023-02-14** (v5) `be19b77aa78a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/pins/get.md)

---

[API](https://skmtc.dev/pinterest/apis/pinterest-rest-api.md) · [All operations](https://skmtc.dev/pinterest/apis/pinterest-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pinterest/apis/pinterest-rest-api/revisions/689b4b267639?raw)