---
title: "Get all assets"
method: GET
path: "/media_library/businesses/{business_id}/assets"
tags: ["media_library"]
---

# Get all assets

`GET /media_library/businesses/{business_id}/assets`

## Request

- Base URL: `https://api.pinterest.com/v5`
- URL: `https://api.pinterest.com/v5/media_library/businesses/{business_id}/assets`
- Auth: OAuth 2
  - Authorization code: `https://www.pinterest.com/oauth/`
  - Token URL: `https://api.pinterest.com/v5/oauth/token` scopes: `ads:read`

Get media library assets for a business. Assets are reusable image or video
creatives at the business level, not Pins. Use this to browse, search, and
filter assets from **Media library**.

Results are paginated. The default `page_size` is 25 and the maximum is 250.
When more assets remain, the response includes a `pagination_token`; pass it
back unchanged to fetch the next page. A request whose filters match nothing
returns HTTP 200 with an empty `assets` array, not a 404.

Access requires the token user to be the business owner or to have a
[Business Access](https://help.pinterest.com/en/business/article/business-manager-overview)
role with media library read access: Admin, Campaign Manager, Analyst, Profile Publisher, or Restricted Owner.

## Path parameters

- `business_id` string, required

## Query parameters

- `names` string[]
- `asset_ids` PinterestLibIntegerFormatType[]
- `asset_types` MediaLibraryAssetType[]
- `has_been_promoted` boolean
- `from_date` string
- `to_date` string
- `tags` string[]
- `sort_order` 'ASC' | 'DESC': Sort order for results by creation date.
- `page_size` integer
- `pagination_token` string

## Response `200`

The request has succeeded.

- MediaLibraryAssetsListResponse: The response payload for a media library assets listing.
  - `assets` MediaLibraryAsset[], required: List of media library assets.
    - union: A media library asset. The concrete shape depends on `asset_type`.
      - object: An image media library asset.
        - `asset_id` string, required: Unique identifier of the asset.
        - `business_id` string, required: Identifier of the business that owns the asset.
        - `asset_type` 'IMAGE', required
        - `name` string, required: Name of the asset.
        - `has_been_promoted` boolean, required: Whether the asset has been used in a pin promotion.
        - `file_extension` 'JPG' | 'PNG' | 'BMP' | 'TIFF' | 'WEBP' | 'MOV' | 'MP4' | 'M4V' | 'AVIF', required: File extension type of the uploaded media.
        - `tags` string[], required: List of tags associated with the asset.
        - `created_at` integer, required: Unix timestamp (milliseconds) when the asset was created.
        - `updated_at` integer, required: Unix timestamp (milliseconds) when the asset was last updated.
        - `image` MediaLibraryAssetImageData: Image renditions for the asset.
          - `sizes` MediaLibraryImageSizes: Renditions keyed by dimension label.
            - `original` MediaLibraryImageProperties: Dimensions and URL for a single image rendition.
              - …
            - `236x` MediaLibraryImageProperties: Dimensions and URL for a single image rendition.
              - …
            - `345x` MediaLibraryImageProperties: Dimensions and URL for a single image rendition.
              - …
      - object: A video media library asset.
        - `asset_id` string, required: Unique identifier of the asset.
        - `business_id` string, required: Identifier of the business that owns the asset.
        - `asset_type` 'VIDEO', required
        - `name` string, required: Name of the asset.
        - `has_been_promoted` boolean, required: Whether the asset has been used in a pin promotion.
        - `file_extension` 'JPG' | 'PNG' | 'BMP' | 'TIFF' | 'WEBP' | 'MOV' | 'MP4' | 'M4V' | 'AVIF', required: File extension type of the uploaded media.
        - `tags` string[], required: List of tags associated with the asset.
        - `created_at` integer, required: Unix timestamp (milliseconds) when the asset was created.
        - `updated_at` integer, required: Unix timestamp (milliseconds) when the asset was last updated.
        - `image` MediaLibraryAssetImageData: Thumbnail image renditions for the video asset.
          - `sizes` MediaLibraryImageSizes: Renditions keyed by dimension label.
            - `original` MediaLibraryImageProperties: Dimensions and URL for a single image rendition.
              - …
            - `236x` MediaLibraryImageProperties: Dimensions and URL for a single image rendition.
              - …
            - `345x` MediaLibraryImageProperties: Dimensions and URL for a single image rendition.
              - …
        - `video` MediaLibraryAssetVideoData: Video format renditions for the asset.
          - `v_720_p` MediaLibraryVideoFormat: Details of a single video format rendition.
            - `duration` integer: Duration in milliseconds.
            - `height` integer: Height in pixels.
            - `width` integer: Width in pixels.
            - `url` string: URL of the video rendition.
          - `v_hlsv3_mobile` MediaLibraryVideoFormat: Details of a single video format rendition.
            - `duration` integer: Duration in milliseconds.
            - `height` integer: Height in pixels.
            - `width` integer: Width in pixels.
            - `url` string: URL of the video rendition.
  - `pagination_token` string: Pagination token for fetching the next page of results. Pass back unchanged as the `pagination_token` request parameter to fetch the next page. Omitted when there are no more results.

## Other responses

- `400`: The request could not be understood by the server due to unexpected data.
- `401`: Authentication is required and has either failed or not been provided.
- `403`: The request was valid, but the server is refusing action. The user might not have the necessary permissions for a resource.
- `404`: The requested resource could not be found on this server.
- `429`: The user has sent too many requests in a given amount of time and is being rate limited.
- `default`: An unexpected error response.

## Changes

- **2026-11-19** (v5) `cc5c1b75cc2c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/media_library/businesses/:business_id/assets/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/19899fd1c8f3?raw)
