List Ad Portfolios
GET/api/advertising/portfolios
Lists Amazon Ads portfolios with their budget caps and campaign counts. Portfolios are mirrored from Amazon on every structure sync (name, state, budget cap and its policy); a portfolio seen only on campaigns that has not been synced yet is still listed, with a placeholder name (Portfolio <id>), null budget fields, editable: false and gap explaining why. Not paginated.
advertising:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Query (optional): ad_account_id, only portfolios on that ad account.
Fields: id (the SKU.io portfolio ID used by Update Ad Portfolio Budget; null when not synced yet), ad_account_id, ad_account_name, portfolio_id (Amazon's portfolio ID, as on each campaign's portfolio_id), name, state (enabled, paused, archived; null when not synced), budget (the cap over the policy period, in currency_code; null for no cap), budget_policy (monthly_recurring, date_range or no_cap), budget_start_date / budget_end_date (Y-m-d, for a date-range cap), currency_code, campaign_count, enabled_campaign_count, daily_budget (sum of the portfolio's campaigns' daily budgets), editable (true when the portfolio is synced and its ad account can write portfolio budgets), gap (null when synced).
meta.editable is true when any row is editable; meta.gap is set when any row is not synced yet, and null otherwise.
Requires the advertising.view permission.
Also requires the advertising-manager feature (Advertising Manager plan); without it the endpoint returns 404.
Request
Responses
- 200
- 401
- 403
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.