Ads API •References / businesses / Get Business by ID
Get Business by ID
Returns business based on a given business id.
Request
- business_idstring [uuid]Required
A unique identifier for the entity.
Example:ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a
Response
A business object.
- idstring [uuid]
A unique identifier for the entity.
Example:"ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
- namestring
The name of the business.
Pattern:^(?!\s*$).+
Length between1
and95
Example:"My Ad Studio Business"
- created_atstring [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_atstring [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"
- statusstring
The status of the business.
Allowed values:"ACTIVE"
- typestring
The type of the business.
Allowed values:"ADVERTISER"
,"AGENCY"
,"MUSIC_ARTIST_CONCERT_PROMOTER"
,"PODCAST_PROMOTER"
Response sample
{ "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"}