> 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-offer-wall/reporting/reporting-api/using-the-reporting-api.md).

# Using the Reporting API

The Offerwall Reporting API is available daily, with a delay of up to 12 hours from the end of the 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 to ensure a complete data capture from the prior day.

{% hint style="info" %}

* You can request a maximum of 50 reports per day.
* The time range for a report query is limited to 90 days.
* You can request a maximum of 5 dimensions in a single query.
* You must set the Date in the Splits array to receive a breakdown by date.
* Data from the Reporting API is for performance analysis only. At the end of each month, DT shares comprehensive data you can use for billing purposes.
  {% endhint %}

**To pull data via the Offer Wall Reporting API, complete the following steps:**

1. [Obtain an access token](#obtaining-an-access-token).
2. [Generate a Reporting API request](#generating-a-report-request).
3. [Download the requested report](#downloading-the-requested-report).

## Obtaining an Access Token

The Offerwall Reporting API uses Access Tokens for authentication. To obtain your access token, you must first obtain your Client ID and Client Secret.

### Obtaining your Client ID and Client Secret

1. Sign in to the [DT Console](https://console.fyber.com/login).
2. On the left menu bar, click **User Profile**.\
   The Advanced Reporting API section appears.

<div align="left" data-with-frame="true"><img src="/files/af3288972c8d5a9df1a2d2fc6036d9275c3b5fab" alt=""></div>

3. (Optional) If necessary, click **Revoke** to delete the current credentials.

<div align="left" data-with-frame="true"><img src="/files/5d7f4b06c30cb6872e1f7fd1a82779cec58aedc3" alt=""></div>

4. Click **Generate New Keys** to receive new credentials.

<div align="left" data-with-frame="true"><img src="/files/4e67d0e59a7e7e3c8fb9c28da469a08e6a15fe47" alt=""></div>

5. Send a POST request to the `/auth/v1/token` endpoint.

## Generating a Report Request

You must include an access token with any report request. For more information about obtaining an access token, see [Obtain an Access Token](#h_01J1X7JJTTF3R9ZT6DN0M94722).

Once you have the access token, send a POST request to the [`/api/v1/report`](/dt-offer-wall/reporting/reporting-api/api-v1-report.md) endpoint to request a custom report. You can specify what data types to include in the report (for a list of supported metrics and dimensions, see [Reporting API Metrics and Dimensions](/dt-offer-wall/reporting/reporting-api/using-the-reporting-api/reporting-api-metrics-and-dimensions.md)).

{% hint style="info" %}

* All monetary values are in US dollars (USD).
* The time zone is UTC.
  {% endhint %}

## Downloading the Requested Report

To download the requested report, poll the URL (signed\_url) from the successful response to a report request. The URL is valid for three hours.

{% hint style="warning" %}
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, your report is complete if any data is present in the report. If your report is still not populated with data after one hour, resend the report request.
{% endhint %}


---

# 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-offer-wall/reporting/reporting-api/using-the-reporting-api.md?ask=<question>&goal=<endgoal>
```

`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.