---
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`

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.

---

[API](https://skmtc.net/pinterest/apis/pinterest-rest-api.md) · [All operations](https://skmtc.net/pinterest/apis/pinterest-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pinterest/pinterest-rest-api/revisions/b698c180678a/schema)
