Skip to main content
GET
Get Ad Library Parent Company

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

parent_company_id
string<uuid>
required

Query Parameters

limit
integer
default:50
Required range: 1 <= x <= 100
offset
integer
default:0
Required range: x >= 0

Response

Successful Response

Advertiser identities grouped under one legal parent.

total_advertisers counts advertisers with at least one ad the caller may see, NOT every row carrying the FK: this reuses the Explore Brands aggregate, which is ad-rooted, so an owned advertiser with no displayable ad forms no group and does not appear. That is the same seam GET /ad-library/brands exists to cover for the library at large.

It also does NOT answer "every consumer brand HEINEKEN owns". Caption-only brands (Strongbow, Durex) have no advertiser row to hang the FK from and need the deferred ad_library_brands table; see the plan's "Scope honesty" section before writing UI copy against this.

generated_at
string<date-time>
required
parent_company
AdLibraryOrgSummary · object
required

A parent company or paying agency, by id + display name.

limit
integer
required
offset
integer
required
total_advertisers
integer
default:0
has_more
boolean
default:false
items
AdLibraryAdvertiserListItem · object[]