Skip to content
Ads APIReferences / 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"

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