Skip to content
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"
    • statusReason
      string

      The status reason of the ad account.

      Allowed values: "FAILED_PAYMENT", "FRAUD_ACTIVITY", "CLOSED_MARKET", "UNSET", "UNRECOGNIZED"

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"    }  ]}