Skip to content
Ads API •References / ad-accounts / Get Ad Accounts for Current User by Business ID

Get Ad Accounts for Current User by Business ID

Returns ad account(s) under a given business for the current authenticated user

Request

  • business_id
    string [uuid]
    Required

    A unique identifier for the entity.

    Example: ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a

Response

A list of BusinessPermissionToAdAccount objects

    • 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"
    • website
      string

      The website associated with the ad account.

      Example: "https://www.spotify.com"
      • name
        string

        Billing name for the account that will appear on bills and invoices.

        Pattern: ^\S.*\S$Length between 2 and 120Example: "Entity_1"
      • 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"
    • legal_entity_name
      string

      The legal name of the entity funding ads for the ad account.

      Supported content-type(s): Example: "Spotify AB"
    • status
      string

      The status of the ad account.

      Allowed values: "ACTIVE", "INACTIVE", "GREY_LISTED", "SUSPEND_LISTED", "BLACKLISTED"
    • status_reason
      string

      The reason for the status of the ad account.

    • name
      string

      Name given to identify your account.

      Pattern: ^\S.*\S$Example: "Nike SB"
    • ad_account_role
      string

      The role of a user in an ad account.

      Allowed values: "AD_ACCOUNT_ADMIN", "AD_ACCOUNT_CONTRIBUTOR", "AD_ACCOUNT_VIEWER"
    • tax_id
      string

      The tax ID on record for the ad account.

      Example: "ATU82660371"
    • currency_code
      string

      The billing currency for the account

      Maximum length: 3Example: "USD"

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", "website": "https://www.spotify.com", "billing_address": { "name": "Entity_1", "street": "123 Spotify Avenue", "city": "Los Angeles", "region": "California", "postal_code": "90210", "tax_region": "ES" }, "legal_entity_name": "Spotify AB", "status": "ACTIVE", "status_reason": "string", "name": "Nike SB", "ad_account_role": "AD_ACCOUNT_ADMIN", "tax_id": "ATU82660371", "currency_code": "USD" } ]}