Skip to content
Ads APIReferences / businesses / Get Businesses for Current User

Get Businesses for Current User

Gets businesses for logged-in user.

Request

GET
/businesses

Response

Array of business objects

    • id
      string [uuid]

      A unique identifier for the entity.

      Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
    • name
      string

      The name of the business.

      Pattern: ^(?!\s*$).+Length between 1 and 95Example: "My Ad Studio Business"
    • 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"
    • status
      string

      The status of the business.

      Allowed values: "ACTIVE"
    • type
      string

      The type of the business.

      Allowed values: "ADVERTISER", "AGENCY", "MUSIC_ARTIST_CONCERT_PROMOTER", "PODCAST_PROMOTER"

Response sample

{  "businesses": [    {      "id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a",      "name": "My Ad Studio Business",      "created_at": "2026-01-23T04:56:07Z",      "updated_at": "2026-01-23T04:56:07Z",      "status": "ACTIVE",      "type": "ADVERTISER"    }  ]}