Ads API •References / ad-accounts / Get Ad Accounts for Current User

Get Ad Accounts for Current User

Returns ad account(s) for the current authenticated user.

Request

limit
integer
Limit or page size for a given response.
Default: limit=50Range: 1 - 50Example: limit=50
offset
integer
Starting position of the next record to assist in data pagination.
Default: offset=0Example: offset=0

Response

A list of ad accounts.

- page_size
  integer [int32]
- total_results
  integer [int32]
- offset
  integer [int32]
- current_page
  integer [int32]
- id
  string [uuid]
  A unique identifier for the entity.
  Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
- business_id
  string [uuid]
  A unique identifier for the entity.
  Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
- created_at
  string [date-time]
  Date the entity was created. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ
  Example: "2026-01-23T04:56:07Z"
- updated_at
  string [date-time]
  Date the entity was updated. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ
  Example: "2026-01-23T04:56:07Z"
- country_code
  string
  The country or region of the geo in ISO alpha-2 country code format.
  Example: "US"
- industry
  string
  The Ad Account's listed industry.
  Example: "Media & Entertainment"
- name
  string
  Name given to identify your entity.
  Pattern: ^\S.*\S$Length between 2 and 120Example: "Entity_1"
- tax_id
  string
  The tax ID on record for the ad account.
  Example: "ATU82660371"
- website
  string
  The website associated with the ad account.
  Example: "https://www.spotify.com"
- street
  string
  Street number and address of ad account.
  Example: "123 Spotify Avenue"
  city
  string
  city of ad account
  Example: "Los Angeles"
  region
  string
  Region where city is located.
  Example: "California"
  postal_code
  string
  Postal code for address.
  Example: "90210"
  tax_region
  string
  Geo in ISO alpha-2 country code format for taxable country.
  Example: "ES"
- display_name
  string
  Nickname to display for ad account.
  Pattern: ^\S.*\S$Example: "Ad Account 2"
- status
  string
  The status of the ad account.
  Allowed values: "ACTIVE", "INACTIVE", "GREY_LISTED", "SUSPEND_LISTED"
- statusReason
  string
  The status reason of the ad account.
  Allowed values: "FAILED_PAYMENT", "FRAUD_ACTIVITY", "CLOSED_MARKET", "UNSET", "UNRECOGNIZED"
- tax_status
  string
  The tax id validation status of the ad account.
  Allowed values: "VALID", "INVALID", "PROCESSING", "UNEXPECTED_ERROR", "RETRYABLE_ERROR", "NON_RETRYABLE_ERROR"

Response sample

{  "paging": {    "page_size": 0,    "total_results": 0,    "offset": 0,    "current_page": 0  },  "ad_accounts": [    {      "id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a",      "business_id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a",      "created_at": "2026-01-23T04:56:07Z",      "updated_at": "2026-01-23T04:56:07Z",      "country_code": "US",      "industry": "Media & Entertainment",      "name": "Entity_1",      "tax_id": "ATU82660371",      "website": "https://www.spotify.com",      "address": {        "street": "123 Spotify Avenue",        "city": "Los Angeles",        "region": "California",        "postal_code": "90210",        "tax_region": "ES"      },      "display_name": "Ad Account 2",      "status": "ACTIVE",      "statusReason": "FAILED_PAYMENT",      "tax_status": "VALID"    }  ]}