---
title: "Get assets assigned to a partner or assets assigned by a partner"
method: GET
path: "/businesses/{business_id}/partners/{partner_id}/assets"
tags: ["business_access_assets"]
---

# Get assets assigned to a partner or assets assigned by a partner

`GET /businesses/{business_id}/partners/{partner_id}/assets`

## Request

- Base URL: `https://api.pinterest.com/v5`
- URL: `https://api.pinterest.com/v5/businesses/{business_id}/partners/{partner_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/partners/:partner_id/assets/get.ts> (a function with typed inputs; its response is checked against the schema)

Can be used to get the business assets your partner has granted you access to or the business assets you have
granted your partner access to. If you specify:
- partner_type=INTERNAL, you will retrieve your business assets that the partner has access to.
- partner_type=EXTERNAL, you will retrieve the partner's business assets that the partner has granted you access to.

## Path parameters

- `business_id` string, required
- `partner_id` string, required

## Query parameters

- `partner_type` 'INTERNAL' | 'EXTERNAL'
- `asset_type` 'AD_ACCOUNT' | 'PROFILE' | 'ASSET_GROUP' | 'PINNER_LIST' | 'CONVERSION_TAG' | 'CATALOG' | 'CONSUMER' | 'CONVERSION_SEGMENT'
- `start_index` integer
- `sort_by` 'NAME' | 'ID' | 'PERMISSIONS': The field to sort member assets by
- `sort_ascending` boolean
- `search_by` 'NAME' | 'ID' | 'NAME_OR_ID' | 'OWNER_NAME' | 'NAME_OR_OWNER': The field to search member assets by
- `search_value` string
- `bookmark` string
- `page_size` integer

## Response `200`

The request has succeeded.

- object
  - `bookmark` string, nullable
  - `items` BaseBusinessAssets[], 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`: 3 breaking, 18 info
  - the `query` request parameter `partner_type` was restricted to a list of enum values
  - for the `query` request parameter `partner_type`, default value `INTERNAL` was added
  - the response's body type changed from no type to `object` for status `200`
  - added the new optional `query` request parameter `search_by`
  - …17 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`: 2 info
  - added the new enum value `CATALOG` to the `query` request parameter `asset_type`
  - added the optional property `allOf[subschema #2]/items/items/asset_group_info/catalogs_ids` to the response with the `200` status
- **2024-08-14** (v5) `89c27ed39cfd`: 2 info
  - added the new enum value `ASSET_GROUP` to the `query` request parameter `asset_type`
  - added the optional property `allOf[subschema #2]/items/items/asset_group_info` to the response with the `200` status
- **2024-04-23** (v5) `f9321315766f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/businesses/:business_id/partners/:partner_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)