Skip to main content

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.

Required scope: advertising:read

Grant 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​

OK

Response Headers
    Content-Type