Skip to content
Ads API •References / ad-accounts / Get Ad Accounts

Get Ad Accounts

Returns ad account(s) information based on given query parameters.

Request

  • limit
    integer

    Limit or page size for a given response.

    Example value: 50Default value: 50Range: 1 - 50
  • offset
    integer

    Starting position of the next record to assist in data pagination.

    Example value: 0Default value: 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 value: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
    • country_code
      string

      The country or region of the geo in ISO alpha-2 country code format.

      Example value: "US"
    • created_at
      string [date-time]

      Date the ad set was created. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ

      Example value: "2026-01-23T04:56:07Z"
    • industry
      string

      The Ad Account's listed industry.

      Example value: "Media & Entertainment"
    • name
      string

      The name of the Ad Account.

      Example value: "Spotify"
    • tax_id
      string

      The tax ID on record for the Ad Account.

      Example value: "ATU82660371"
    • updated_at
      string [date-time]

      Date the ad set was updated. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ

      Example value: "2026-01-23T04:56:07Z"
    • website
      string

      The website associated with the Ad Account.

      Example value: "https://www.spotify.com"

Response sample

{  "paging": {    "page_size": 0,    "total_results": 6,    "offset": 1,    "current_page": 5  },  "ad_accounts": [    {      "id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a",      "country_code": "US",      "created_at": "2026-01-23T04:56:07Z",      "industry": "Media & Entertainment",      "name": "Spotify",      "tax_id": "ATU82660371",      "updated_at": "2026-01-23T04:56:07Z",      "website": "https://www.spotify.com"    },    {      "id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a",      "country_code": "US",      "created_at": "2026-01-23T04:56:07Z",      "industry": "Media & Entertainment",      "name": "Spotify",      "tax_id": "ATU82660371",      "updated_at": "2026-01-23T04:56:07Z",      "website": "https://www.spotify.com"    }  ]}