Skip to content
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_id
    string [uuid]
    Required

    A unique identifier for an Ad Account.

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

Response

An ad account.

  • 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

{  "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"}