Ads API •References / ad-accounts / Get Ad Accounts
Get Ad Accounts
Returns ad account(s) information based on given query parameters.
Request
- limitinteger
Limit or page size for a given response.
Example value:50
Default value:50
Range:1
-50
- offsetinteger
Starting position of the next record to assist in data pagination.
Example value:0
Default value:0
Response
A list of ad accounts.
- page_sizeinteger [int32]
- total_resultsinteger [int32]
- offsetinteger [int32]
- current_pageinteger [int32]
- idstring [uuid]
A unique identifier for the entity.
Example value:"ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
- country_codestring
The country or region of the geo in ISO alpha-2 country code format.
Example value:"US"
- created_atstring [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"
- industrystring
The Ad Account's listed industry.
Example value:"Media & Entertainment"
- namestring
The name of the Ad Account.
Example value:"Spotify"
- tax_idstring
The tax ID on record for the Ad Account.
Example value:"ATU82660371"
- updated_atstring [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"
- websitestring
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" } ]}