---
title: "Get AOAA requests"
method: GET
path: "/businesses/{business_id}/ad_account_requests"
tags: ["business_access_invite"]
---

# Get AOAA requests

`GET /businesses/{business_id}/ad_account_requests`

## Request

- Base URL: `https://api.pinterest.com/v5`
- URL: `https://api.pinterest.com/v5/businesses/{business_id}/ad_account_requests`
- Auth: OAuth 2
  - Authorization code: `https://www.pinterest.com/oauth/`
  - Token URL: `https://api.pinterest.com/v5/oauth/token` scopes: `biz_access:read`

Get Agency Owned Ad Account (AOAA) requests.

## Path parameters

- `business_id` string, required

## Query parameters

- `partner_id` string
- `request_ids` PinterestLibIntegerFormatType[]
- `statuses` AgencyOwnedAdAccountRequestStatus[]
- `request_direction` 'SENT' | 'RECEIVED' | 'ALL': AOAA request direction.

## Response `200`

The request has succeeded.

- AgencyOwnedAdAccountRequest[]
  - `request_id` string, required
  - `name` string, required: Requested ad account name.
  - `country` string, required: Ad account country.
  - `currency` 'UNK' | 'USD' | 'GBP' | 'CAD' | 'EUR' | 'AUD' | 'NZD' | 'SEK' | 'ILS' | 'CHF' | 'HKD' | 'JPY' | 'SGD' | 'KRW' | 'NOK' | 'DKK' | 'PLN' | 'RON' | 'HUF' | 'CZK' | 'BRL' | 'MXN' | 'ARS' | 'CLP' | 'COP' | 'INR' | 'TRY': Currency Codes from ISO 4217
  - `status` 'PENDING' | 'ACCEPTED' | 'DECLINED' | 'CANCELED' | 'EXPIRED', required: AOAA request status.
  - `permissions` object[]: Permissions grouped by business user id.
  - `owner_business` AgencyOwnedAdAccountRequestBusinessSummary, required: Business profile information included in AOAA requests.
    - `id` string, required
    - `full_name` string, required: Business display name.
    - `username` string, required: Business username.
    - `image_medium_url` string, required: URL of the medium image profile.
    - `image_small_url` string, required: URL of the small image profile.
  - `client_business` AgencyOwnedAdAccountRequestBusinessSummary, required: Business profile information included in AOAA requests.
    - `id` string, required
    - `full_name` string, required: Business display name.
    - `username` string, required: Business username.
    - `image_medium_url` string, required: URL of the medium image profile.
    - `image_small_url` string, required: URL of the small image profile.

## 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-11-19** (v5) `cc5c1b75cc2c`: 1 info
  - endpoint added

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