Run Saved Ad Report
GET/api/advertising/reports/:report/run
Runs a saved report's definition now and returns the rows (same shape as Run Ad Report). A relative window is evaluated against today. Returns 422 if the stored dimensions cannot be combined.
advertising:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Requires the advertising.view permission.
Also requires the advertising-manager feature (Advertising Manager plan); without it the endpoint returns 404.
Money is in the tenant currency, except for reports with the hour dimension: hourly figures stay in each ad account's currency, so hourly rows carry a currency_code column (listed in columns as the Currency dimension) and are never summed across currencies. A report split by product whose rows exceed the roll-up cap returns partial figures (the highest-spend rows), with truncated: true and a note.
Request
Responses
- 200
- 401
- 403
- 404
- 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.
Not Found
Response Headers
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.