Skip to main content

List Launches

GET 

/api/advertising/launches

Lists launches, newest first. Launch status is draft, scheduled (a later wave is pending; next_wave_at is its due date), in_progress, completed or cancelled. Each wave's status is pending, submitted, skipped (no product passed the gate), failed or cancelled.

Required scope: advertising:read

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Requires the advertising.view permission and the Advertising Manager feature.

Filters (optional): ad_account_id, status. Paginated: per_page defaults to 10, maximum 200.

Each launch also carries products: the SKU and name of every product in product_ids, in the same order (sku / name are null for a product that no longer exists).

Request​

Responses​

OK

Response Headers
    Content-Type