> For the complete documentation index, see [llms.txt](https://docs.digitalturbine.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digitalturbine.com/dt-growth/reporting-api/using-the-reporting-api.md). # Using the Reporting API The DT Growth Reporting API is available daily, with a delay of **up to 12 hours** from the end of day UTC. Due to this delay, DT recommends waiting 12 hours after the end of the day UTC before generating a report for the previous day. If you request a report before this time, DT recommends requesting another report after the 12-hour window in order to ensure a complete data capture for the previous day. {% hint style="info" %} * You can request a maximum of **100 reports per day.** * You can request a maximum of **5 reports per minute.** * Data from the Reporting API is for performance analysis only. At the end of each month, DT shares comprehensive data that you can use for billing purposes. {% endhint %} **To pull data via the Growth Reporting API, complete the following steps:** {% stepper %} {% step %} [Obtain an access token](/dt-growth/reporting-api/using-the-reporting-api.md#obtain-an-access-token) {% endstep %} {% step %} [Generate a Reporting API request](/dt-growth/reporting-api/using-the-reporting-api.md#generate-a-report-request) {% endstep %} {% step %} [Download the requested report](/dt-growth/reporting-api/using-the-reporting-api.md#download-the-requested-report) {% endstep %} {% endstepper %} ## Obtain an Access Token All requests for performance data via the Reporting API require an access token. To obtain an access token, you must first request credentials from your DT Representative and then pass those credentials using the `POST` method and [`/auth/v1/token`](/dt-growth/reporting-api/reporting-api-endpoints/api-v1-token.md) endpoint. The Reporting API responds with your access token that is valid for 1 hour. **To obtain an access token**: 1. Request Reporting API access credentials ( **Client ID** and **Client Secret**) from your DT Representative. Your DT Representative sends your credentials according to OAuth 2.0 protocol in an encrypted email via Proofpoint. Proofpoint then notifies you via email that you have an encrypted email. 2. In the notification email from Proofpoint, either click the link to create a Proofpoint Encryption account, or, if you already have a Proofpoint account, click the link to log in to your account. If either the link lands on page with an error, download and open the attached file in notification email. Opening the file should trigger the login process. Once logged in, you can view the encrypted email that contains your Reporting API access credentials. If you have trouble accessing the encrypted email in Proofpoint, contact your DT Representative. 3. Send a request using the `POST` method and the [`/auth/v1/token`](/dt-growth/reporting-api/reporting-api-endpoints/api-v1-token.md) endpoint. ## Generate a Report Request You must include an access token with any report request. For more information about how to obtain an access token, see [Obtain an Access Token](#obtain-an-access-token). Once you obtain the access token, use the `POST` method and the [`/api/v1/report`](/dt-growth/reporting-api/reporting-api-endpoints/api-v1-report.md) endpoint to request a custom report. You can use various supported metrics and dimensions to specify what types of data to include in the report. For a complete list of supported metrics and dimensions, see [Reporting API Metrics and Dimensions](/dt-growth/reporting-api/reporting-api-metrics-and-dimensions.md). All generated reports have the following features: * All monetary data is in **US dollars (USD)**. * The time zone of the report is **UTC**. ## Download the Requested Report To download the requested report, perform polling on the URL (`signed_url`) from the [successful response to a report request](/dt-growth/reporting-api/reporting-api-endpoints/api-v1-report.md#successful-report-request-response). The URL is valid for three hours. Initial polling of the URL may show no report data. The Reporting system may take up to one hour to populate the report according to the report request. The Reporting system adds all report data to the empty report at once. Therefore, if there is any data present in the report, your report is complete. If your report is still not populated with data after one hour, resend the report request. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.digitalturbine.com/dt-growth/reporting-api/using-the-reporting-api.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.