[Tenjin API Reference](https://api-docs.tenjin.com/llms.txt) › Reporting Metrics API

- Reporting Metrics API OpenAPI spec: https://api-docs.tenjin.com/openapi/reporting-metrics-api.json

# Reporting Metrics API

- **OpenAPI Version:** `3.2.0`
- **API Version:** `2.1.0`

# Introduction

Pull your Tenjin Data Exporter metrics through the API: user acquisition, ad revenue and SKAN reports, and
the saved reports that store their settings. The
[Metric Definitions](https://api-docs.tenjin.com/metric_definitions) page lists the metrics you can report on.

## Access to the API

The API is served from `https://api.tenjin.com`, and every path starts with the API version, for example `https://api.tenjin.com/v2/reports/spend`.

## Rate limiting

Each access token can make up to 100 report requests (paths under
`/v2/reports`) per minute. A request over the limit gets status 429, and its `X-Retry-After` header gives
the length of the limit period in seconds.

## Servers

- **URL:** `https://api.tenjin.com`

## Authentication

- **Bearer**: HTTP bearer (`JWT`)

  Generate an access token on the [Access Tokens](https://dashboard.tenjin.com/dashboard/access_tokens) page of the Tenjin dashboard and send it as `Authorization: Bearer <access token>`. [API access tokens](https://tenjin.com/docs/api-access-tokens/) explains them.


## Operations

### Reporting Metrics

- [Pull an SKAdNetwork report from AdNetwork postbacks](https://api-docs.tenjin.com/reporting-metrics-api/get_reports_skan_ad_network.md): `GET /v2/reports/skan_ad_network`
- [Pull an SKAdNetwork report from AdNetwork postbacks](https://api-docs.tenjin.com/reporting-metrics-api/get_reports_sk_ad_network.md): `GET /v2/reports/sk_ad_network`
- [Pull an SKAdNetwork report from Apple postbacks](https://api-docs.tenjin.com/reporting-metrics-api/get_reports_skan_apple.md): `GET /v2/reports/skan_apple`
- [Pull a spend report](https://api-docs.tenjin.com/reporting-metrics-api/get_reports_spend.md): `GET /v2/reports/spend`
- [Pull an ad revenue report](https://api-docs.tenjin.com/reporting-metrics-api/get_reports_ad_revenue.md): `GET /v2/reports/ad_revenue`
- [Pull data from a saved report](https://api-docs.tenjin.com/reporting-metrics-api/get_reports_id.md): `GET /v2/reports/{id}`

### Saved Reports

- [List saved reports](https://api-docs.tenjin.com/reporting-metrics-api/get_saved_reports.md): `GET /v2/saved_reports`
- [Create a saved report](https://api-docs.tenjin.com/reporting-metrics-api/post_saved_reports.md): `POST /v2/saved_reports`
- [Get a saved report](https://api-docs.tenjin.com/reporting-metrics-api/get_saved_reports_id.md): `GET /v2/saved_reports/{id}`
- [Update a saved report](https://api-docs.tenjin.com/reporting-metrics-api/patch_saved_reports_id.md): `PATCH /v2/saved_reports/{id}`
- [Delete a saved report](https://api-docs.tenjin.com/reporting-metrics-api/delete_saved_reports_id.md): `DELETE /v2/saved_reports/{id}`