PIpinterest
ad_accounts

Get the account analytics report created by the async call

Changed on

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

Request

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"
}

Changes

  • v5b698c180678aRevision changes
    • warning

      added the new CANCELLED enum value to the response property for the response status

    • warning

      added the new DOES_NOT_EXIST enum value to the response property for the response status

    • warning

      added the new EXPIRED enum value to the response property for the response status

    • warning

      added the new FAILED enum value to the response property for the response status

    • warning

      added the new FINISHED enum value to the response property for the response status

    • warning

      added the new IN_PROGRESS enum value to the response property for the response status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      removed from the response property allOf list for the response status

  • v5be19b77aa78aRevision changes
    • info

      added to the response property allOf list for the response status