Skip to main content

List Product Goals

GET 

/api/advertising/goals

Lists the product goals currently in force (open goals), one row per product and scope (a specific ad account, or all accounts). Sorted newest first by effective_from, then by ID. Paginated, 10 per page by default (max 200).

Required scope: advertising:read

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

Requires the advertising.view permission; the tenant must have the advertising-manager feature enabled.

Filters (all optional, exact match): product_id, ad_account_id, goal (profit, growth, launch, liquidate, defend, hold), set_by (user, advisor, guardrail).

account is null for goals that apply to all accounts.

Request​

Responses​

OK

Response Headers
    Content-Type