Ads API •References / ad-accounts / Get an Ad Account by ID

Get an Ad Account by ID

Returns a single ad account based on query parameters.

Request

ad_account_id
string [uuid]
Required
A unique identifier for an Ad Account.
Example: ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a

Response

An ad account.

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", "GREY_LISTED", "SUSPEND_LISTED"
statusReason
string
The status reason of the ad account.
Allowed values: "FAILED_PAYMENT", "FRAUD_ACTIVITY", "CLOSED_MARKET", "UNSET", "UNRECOGNIZED"
tax_status
string
The tax id validation status of the ad account.
Allowed values: "VALID", "INVALID", "PROCESSING", "UNEXPECTED_ERROR", "RETRYABLE_ERROR", "NON_RETRYABLE_ERROR"

Response sample

{  "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",  "tax_status": "VALID"}