Skip to main content
GET
/
advertisers
/
{advertiserId}
/
accounts
/
available
List available accounts
curl --request GET \
  --url https://api.agentic.scope3.com/api/v2/buyer/advertisers/{advertiserId}/accounts/available \
  --header 'Authorization: Bearer <token>'
{
  "accounts": [
    {
      "accountId": "acc_acme_pinnacle",
      "partnerId": "partner_abc",
      "partnerName": "Google Ads",
      "status": "active",
      "name": "Acme c/o Pinnacle",
      "advertiser": "Acme Corp",
      "billingProxy": "Pinnacle Media",
      "house": "acme-corp.com",
      "billing": "brand"
    }
  ],
  "total": 8,
  "synced": true,
  "billingOptions": {
    "default": "<string>",
    "supported": [
      "<string>"
    ]
  }
}

Authorizations

​
Authorization
string
header
required

API key or access token

Path Parameters

​
advertiserId
string
required

Unique identifier for the advertiser

Minimum string length: 1
Example:

"12345"

Query Parameters

​
partnerId
string
required

Filter by partner ID (required)

Minimum string length: 1
Example:

"partner_abc"

​
refresh
enum<string>

When true, re-fetches accounts from the partner agent before returning results. Defaults to false (returns cached accounts).

Available options:
true,
false
Example:

"false"

​
billingType
string

Billing arrangement type to filter accounts by (e.g. "brand", "agency"). Must be one of the values supported by this partner agent. Defaults to the partner's default billing type if omitted.

Example:

"brand"

​
take
integer
default:50

Number of results to return (max 250)

Required range: x <= 250
Example:

50

​
skip
integer
default:0

Number of results to skip for pagination

Required range: 0 <= x <= 9007199254740991
Example:

0

Response

List available accounts

Response containing a list of available accounts from a partner

​
accounts
object[]
required

List of available (discovered) accounts

​
total
integer
required

Total count of available accounts

Required range: 0 <= x <= 9007199254740991
Example:

8

​
synced
boolean

True when no accounts matched and a sync_accounts call was automatically triggered to provision this account at the partner. The list reflects the post-sync state.

​
billingOptions
object

Billing options supported by this partner agent, as reported in its ADCP capabilities.