v29

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-06-042661,1122.5 MB
ad_accounts

Get the account analytics report created by the async call

This returns a URL to an analytics report given a token returned from the post request report creation call. You can use the URL to download the report. The link is valid for five minutes and the report is valid for one hour.

  • The token's user_account must either be the Owner of the specified ad account, or have one of the necessary roles granted to them via Business Access: Admin, Analyst, Campaign Manager.
get/ad_accounts/{ad_account_id}/reports

Path parameters

ad_account_idstring required

Unique identifier of an ad account.

Query parameters

tokenstring required

Token returned from the post request creation call

Response

The request has succeeded.

report_status'DOES_NOT_EXIST' | 'FINISHED' | 'IN_PROGRESS' | 'EXPIRED' | 'FAILED' | 'CANCELLED'

Possible status for a bulk reporting job

sizenumber nullable
urlstring nullable

Example response

{
  "report_status": "FINISHED"
}