---
title: "List accounts with access to an audience owned by a business"
method: GET
path: "/businesses/{business_id}/audiences/shared/accounts"
tags: ["audience_sharing"]
---

# List accounts with access to an audience owned by a business

`GET /businesses/{business_id}/audiences/shared/accounts`

## Request

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

List all ad accounts and/or businesses that have access to a specific audience. The audience must either be owned by an ad account in the requesting business, or it must have been shared with the requesting business. If the requesting business is not the owner of the audience, only ad accounts owned by the requesting business will be returned.

## Path parameters

- `business_id` string, required

## Query parameters

- `audience_id` string, required
- `account_type` 'AD_ACCOUNT' | 'BUSINESS_ACCOUNT', required: Account type filter for audience sharing.
- `bookmark` string
- `page_size` integer

## Response `200`

The request has succeeded.

- object
  - `bookmark` string, nullable
  - `items` SharedAudienceAccount[], required
    - `account_id` string, required: Account ID (ad account or business ID).
    - `account_name` string, required: Account name.
    - `account_type` 'AD_ACCOUNT' | 'BUSINESS_ACCOUNT', required: Account type filter for audience sharing.
    - `shared_on_timestamp` integer, required: Epoch timestamp in seconds for the shared audience event

## 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, 6 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 `401`
  - added the non-success response with the status `403`
  - …3 more
- **2024-08-14** (v5) `89c27ed39cfd`: 1 info
  - endpoint added

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