v29

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-06-042661,1122.5 MB

business_access_assets

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

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.

get/businesses/{business_id}/partners/{partner_id}/assets

Path parameters

business_idstring required

Unique identifier of the requesting business.

partner_idstring required

The partner id to be bound to the Business

Query parameters

partner_type'INTERNAL' | 'EXTERNAL'

Specifies whether to fetch internal or external (shared) partners.

If partner_type=INTERNAL, the asset being queried is for accesses the partner has to your business assets.

If partner_type=EXTERNAL, the asset being queried is for the accesses you have to the partner's business asset.

A resource type to filter the assets by. Only assets of the specified type will be returned.

start_indexinteger

An index to start fetching the results from. Only the results starting from this index will be returned.

sort_by'NAME' | 'ID' | 'PERMISSIONS'

The field to sort member assets by

Example:NAME

The field to sort member assets by

sort_ascendingboolean

Sort assets in ascending order

search_by'NAME' | 'ID' | 'NAME_OR_ID' | 'OWNER_NAME' | 'NAME_OR_OWNER'

The field to search member assets by

Example:NAME

The field to search member assets by

search_valuestring

The value to search for

bookmarkstring

Cursor used to fetch the next page of items

page_sizeinteger

Maximum number of items to include in a single page. See documentation on Pagination for more information.

Response

The request has succeeded.

bookmarkstring nullable

Example response

{
  "items": [
    {
      "asset_group_info": {
        "ad_accounts_ids": [
          "549755885175"
        ],
        "asset_group_description": "Asset group that has ad accounts used in Canada",
        "asset_group_name": "Canada Ad Accounts",
        "asset_group_types": [
          "LOCATION_OR_LANGUAGE"
        ],
        "catalogs_ids": [
          "4836859046874"
        ],
        "created_by": {
          "email": "business0101@business.com",
          "id": "549755885175",
          "username": "business0101"
        },
        "created_time": 1646767577816,
        "id": "666791336903426391",
        "owner": {
          "email": "business0101@business.com",
          "id": "549755885175",
          "username": "business0101"
        },
        "profiles_ids": [
          "630433785246278264"
        ],
        "updated_time": 1646767577816
      },
      "asset_id": "549755885175",
      "asset_type": "AD_ACCOUNT",
      "permissions": [
        "FINANCE_MANAGER",
        "CATALOGS_MANAGER",
        "AUDIENCE_MANAGER"
      ]
    }
  ]
}