---
title: "List business assets"
method: GET
path: "/businesses/{business_id}/assets"
tags: ["business_access_assets"]
---

# List business assets

`GET /businesses/{business_id}/assets`

## Request

- Base URL: `https://api.pinterest.com/v5`
- URL: `https://api.pinterest.com/v5/businesses/{business_id}/assets`
- Auth: OAuth 2
  - Authorization code: `https://www.pinterest.com/oauth/`
  - Token URL: `https://api.pinterest.com/v5/oauth/token` scopes: `biz_access:read`
- TypeScript: <https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/businesses/:business_id/assets/get.ts> (a function with typed inputs; its response is checked against the schema)

Get all the assets the requesting business has access to. This includes assets the business owns and assets the business has access to through partnerships.

## Path parameters

- `business_id` string, required

## Query parameters

- `permissions` PermissionsWithOwner[]
- `child_asset_id` string
- `asset_group_id` string
- `asset_type` 'AD_ACCOUNT' | 'PROFILE' | 'ASSET_GROUP' | 'CATALOG' | 'CONSUMER'
- `start_index` integer
- `bookmark` string
- `page_size` integer

## Response `200`

The request has succeeded.

- object
  - `bookmark` string, nullable
  - `items` BusinessAssets[], required
    - `asset_group_info` AssetGroupBinding
      - `ad_accounts_ids` AssetGroupBindingAdAccountsIdsItems[], required: A list of ad account IDs under the asset group
      - `asset_group_description` string, nullable, required: Asset group description
      - `asset_group_name` string, nullable, required: Asset Group name
      - `asset_group_types` string[], required: Asset group types
      - `catalogs_ids` AssetGroupBindingCatalogsIdsItems[], required: A list of catalog IDs under asset group
      - `created_by` BusinessAccessUserSummary, required: Metadata of the member/partner that has access to the asset.
        - `email` string, nullable: Email of the business member/partner.
        - `id` string, nullable: Unique identifier of the business member/partner.
        - `username` string, nullable: Username of the business member/partner.
      - `created_time` integer, nullable, required: The creation time of the asset group
      - `id` string, required: Asset Group ID.
      - `owner` BusinessAccessUserSummary, required: Metadata of the member/partner that has access to the asset.
        - `email` string, nullable: Email of the business member/partner.
        - `id` string, nullable: Unique identifier of the business member/partner.
        - `username` string, nullable: Username of the business member/partner.
      - `profiles_ids` AssetGroupBindingProfilesIdsItems[], required: A list of profile IDs under asset group
      - `updated_time` integer, nullable, required: The last update time of the asset group
    - `asset_id` string: Unique identifier of a business asset.
    - `asset_type` 'AD_ACCOUNT' | 'MERCHANT' | 'PROFILE' | 'ASSET_GROUP' | 'PINNER_LIST' | 'CONVERSION_TAG' | 'CATALOG' | 'CONVERSION_SEGMENT': Type of asset. Currently we only support AD_ACCOUNT, PROFILE, ASSET_GROUP and CATALOG.
    - `permissions` string[]: Permission levels the requesting business has on an asset.

## 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-06-04** (v5) `b698c180678a`: 1 breaking, 8 info
  - the response's body type changed from no type 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`
  - …5 more
- **2025-07-16** (v5) `43134ca41f18`: 1 info
  - added the new enum value `CONSUMER` to the `query` request parameter `asset_type`
- **2025-04-04** (v5) `10f9eba4ad97`: 5 info
  - added the new enum value `CATALOG` to the `query` request parameter `asset_type`
  - added the enum value `FINANCE_EDIT` to the property `items/` of the `query` request parameter `permissions`
  - added the enum value `FINANCE_VIEW` to the property `items/` of the `query` request parameter `permissions`
  - added the optional property `allOf[subschema #2]/items/items/asset_group_info/catalogs_ids` to the response with the `200` status
  - …1 more
- **2024-08-14** (v5) `89c27ed39cfd`: 5 info
  - added the new optional `query` request parameter `asset_group_id`
  - added the new optional `query` request parameter `child_asset_id`
  - added the new enum value `ASSET_GROUP` to the `query` request parameter `asset_type`
  - added the enum value `CATALOGS_VIEWER` to the property `items/` of the `query` request parameter `permissions`
  - …1 more
- **2024-04-23** (v5) `f9321315766f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/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/b698c180678a?raw)