# Reporting API V2

OpenAPI 3.0 spec of the Reporting API.

<!-- theme: info -->
> ### Beta datasets
>
> Datasets marked as **(beta)** are subject to change or removal without prior notice, and are offered as is with no support.


Version: 1.0.0

## Servers

Live Server
```
https://api.mediamath.com/reporting/v2
```

## Security

### Auth0

Type: oauth2
Authorization URL: https://auth.mediamath.com/authorize
Token URL: https://auth.mediamath.com/oauth/token
Scopes:
- `offline_access`: for refresh tokens

## Download OpenAPI description

 - [Reporting API V2](https://apidocs.mediamath.com/_bundle/apis/reporting-api/openapi.yaml)

## Common

 - [GET /](https://apidocs.mediamath.com/apis/reporting-api/openapi/common/paths/~1/get.md): Lists the datasets available to the authenticated user, along with their metadata.
## Datasets

 - [GET /all-dimensions-and-metrics](https://apidocs.mediamath.com/apis/reporting-api/openapi/datasets/paths/~1all-dimensions-and-metrics/get.md): Returns the documentation of the dataset: its fields, supported time windows and rollups.
 - [POST /all-dimensions-and-metrics](https://apidocs.mediamath.com/apis/reporting-api/openapi/datasets/paths/~1all-dimensions-and-metrics/post.md): Standard performance metrics in campaign currency and broken out by our widest array of dimensions. Available in custom date ranges or intervals with the option to aggregate by day, week, or month. ##
 - [GET /brain-feature-summary](https://apidocs.mediamath.com/apis/reporting-api/openapi/datasets/paths/~1brain-feature-summary/get.md): Returns the documentation of the dataset: its fields, supported time windows and rollups.
 - [POST /brain-feature-summary](https://apidocs.mediamath.com/apis/reporting-api/openapi/datasets/paths/~1brain-feature-summary/post.md): Brain Feature Summary Report ### Fields | Field | Time Windows | Rollups | | --- | --- | --- | | **Dimensions** | | | | `agg_timestamp` | `yesterday`, `last_X_days`, `month_to_date` | `by_day` | |
 - [GET /brain-feature-value](https://apidocs.mediamath.com/apis/reporting-api/openapi/datasets/paths/~1brain-feature-value/get.md): Returns the documentation of the dataset: its fields, supported time windows and rollups.
 - [POST /brain-feature-value](https://apidocs.mediamath.com/apis/reporting-api/openapi/datasets/paths/~1brain-feature-value/post.md): Brain Feature Value Report ### Fields | Field | Time Windows | Rollups | | --- | --- | --- | | **Dimensions** | | | | `agg_timestamp` | `yesterday`, `last_X_days`, `month_to_date` | `by_day` | | `a
 - [GET /day-part](https://apidocs.mediamath.com/apis/reporting-api/openapi/datasets/paths/~1day-part/get.md): Returns the documentation of the dataset: its fields, supported time windows and rollups.
 - [POST /day-part](https://apidocs.mediamath.com/apis/reporting-api/openapi/datasets/paths/~1day-part/post.md): Standard performance metrics broken out by time of day and day of week. Available in standard intervals. ### Fields | Field | Time Windows | Rollups | | --- | --- | --- | | **Dimensions** | | | | `
 - [GET /deals](https://apidocs.mediamath.com/apis/reporting-api/openapi/datasets/paths/~1deals/get.md): Returns the documentation of the dataset: its fields, supported time windows and rollups.
 - [POST /deals](https://apidocs.mediamath.com/apis/reporting-api/openapi/datasets/paths/~1deals/post.md): Metrics that describe the path from a matched bid opportunity (biddable) to a delivered impression (win) for private marketplace deals. The data is stored in UTC timezone and is available by hour. **N
 - [GET /performance](https://apidocs.mediamath.com/apis/reporting-api/openapi/datasets/paths/~1performance/get.md): Returns the documentation of the dataset: its fields, supported time windows and rollups.
 - [POST /performance](https://apidocs.mediamath.com/apis/reporting-api/openapi/datasets/paths/~1performance/post.md): Standard Aggregated Performance Report in Campaign Currency ### Fields | Field | Time Windows | Rollups | | --- | --- | --- | | **Dimensions** | | | | `agg_timestamp` | `current_day`, `yesterday`,
 - [GET /performance-hourly](https://apidocs.mediamath.com/apis/reporting-api/openapi/datasets/paths/~1performance-hourly/get.md): Returns the documentation of the dataset: its fields, supported time windows and rollups.
 - [POST /performance-hourly](https://apidocs.mediamath.com/apis/reporting-api/openapi/datasets/paths/~1performance-hourly/post.md): Standard Aggregated Performance Report in Campaign Currency ### Fields | Field | Time Windows | Rollups | | --- | --- | --- | | **Dimensions** | | | | `agg_timestamp` | `current_day`, `last_X_hours
 - [GET /pixel-loads](https://apidocs.mediamath.com/apis/reporting-api/openapi/datasets/paths/~1pixel-loads/get.md): Returns the documentation of the dataset: its fields, supported time windows and rollups.
 - [POST /pixel-loads](https://apidocs.mediamath.com/apis/reporting-api/openapi/datasets/paths/~1pixel-loads/post.md): Loads and Uniques metrics for `data` and `event` pixels, broken out by referrer and referrer rank, available by day. ### Fields | Field | Time Windows | Rollups | | --- | --- | --- | | **Dimensions**
 - [GET /reach-frequency](https://apidocs.mediamath.com/apis/reporting-api/openapi/datasets/paths/~1reach-frequency/get.md): Returns the documentation of the dataset: its fields, supported time windows and rollups.
 - [POST /reach-frequency](https://apidocs.mediamath.com/apis/reporting-api/openapi/datasets/paths/~1reach-frequency/post.md): Basic performance metrics as well as the "uniques" metric, broken out by frequency of ad exposure. Available in standard intervals. ### Fields | Field | Time Windows | Rollups | | --- | --- | --- |
 - [GET /win-loss](https://apidocs.mediamath.com/apis/reporting-api/openapi/datasets/paths/~1win-loss/get.md): Returns the documentation of the dataset: its fields, supported time windows and rollups.
 - [POST /win-loss](https://apidocs.mediamath.com/apis/reporting-api/openapi/datasets/paths/~1win-loss/post.md): Metrics describe the auction before a win or even a bid has taken place. Broken out by strategy, exchange, and deal dimensions and available by hour. ### Fields | Field | Time Windows | Rollups | |