Ads API •References / ad-accounts / Get an Ad Account
Get an Ad Account
Returns a single ad account based on query parameters.
Request
- ad_account_idstring [uuid]Required
A unique identifier for an Ad Account.
Example value:"ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
Response
An ad account.
- 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
{ "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"}