---
title: "Get the account analytics report created by the async call"
method: GET
path: "/ad_accounts/{ad_account_id}/reports"
tags: ["ad_accounts"]
---

# Get the account analytics report created by the async call

`GET /ad_accounts/{ad_account_id}/reports`

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](https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts): Admin, Analyst, Campaign Manager.

## Path parameters

- `ad_account_id` string, required

## Query parameters

- `token` string, required

## Response `200`

The request has succeeded.

- AdsAnalyticsGetAsyncResponse
  - `report_status` 'DOES_NOT_EXIST' | 'FINISHED' | 'IN_PROGRESS' | 'EXPIRED' | 'FAILED' | 'CANCELLED' — Possible status for a bulk reporting job
  - `size` number, nullable
  - `url` string, nullable

## Other responses

- `400` — The request could not be understood by the server due to unexpected data.
- `401` — Authentication is required and has either failed or not been provided.
- `403` — The request was valid, but the server is refusing action. The user might not have the necessary permissions for a resource.
- `404` — The requested resource could not be found on this server.
- `429` — The user has sent too many requests in a given amount of time and is being rate limited.
- `default` — An unexpected error response.

---

[API](https://skmtc.net/pinterest/apis/pinterest-rest-api.md) · [All operations](https://skmtc.net/pinterest/apis/pinterest-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pinterest/pinterest-rest-api/revisions/b698c180678a/schema)