---
title: "List saved reports"
method: GET
path: "/v2/saved_reports"
tags: ["Saved Reports"]
---

# List saved reports

`GET /v2/saved_reports`

## Request

- Base URL: `https://api.tenjin.com`
- URL: `https://api.tenjin.com/v2/saved_reports`
- Auth: HTTP bearer

## Query parameters

- `report_type` 'user_acquisition' | 'ad_revenue'
- `page` integer
- `per_page` integer

## Response `200`

Saved reports

- SavedReportListDocument
  - `data` SavedReportResource[], required
    - `id` string, uuid, required
    - `type` 'saved_report', required
    - `attributes` object, required
      - `name` string, required: Name of the saved report
      - `past_number_days` integer, required: Number of days before today that the report covers
      - `metrics` string[], required: Metrics of the report
      - `granularity` 'daily' | 'weekly' | 'monthly' | 'totals-daily', required: Granularity of the report
      - `report_type` 'user_acquisition' | 'ad_revenue', required: `user_acquisition` for a spend report, `ad_revenue` for an ad revenue report
      - `channel_ids` integer[], required: Ids of the channels the report covers; all when empty
      - `app_ids` string[], required: Ids of the apps the report covers; all when empty
      - `group_by` string, nullable, required: The dimension the report groups by, or the name of its combination: `channel_app_country`, `channel_app`, `campaign_country`, `app_country`. A report saved outside the API can hold several dimensions, comma-separated (`app,site`). Null when a stored dimension has no API name
  - `links` Links, required
    - `self` string, uri, required: URL of this request
    - `first` string, uri: URL of the first page of a list
    - `prev` string, uri: URL of the previous page of a list
    - `next` string, uri: URL of the next page of a list
    - `last` string, uri: URL of the last page of a list
  - `meta` PageMeta, required
    - `count` integer, required: Number of items on all pages
    - `per_page` integer, required: Number of items per page

## Other responses

- `400`: A param is missing or invalid, a record is not found, or the request cannot be served
- `401`: Missing or invalid credentials, or no access to the requested data
- `403`: Invalid token, or the user's role does not allow the request
- `498`: Expired token, or a token with an invalid signature

---

[API](https://skmtc.dev/tenjin/apis/reporting-metrics-api.md) - [All operations](https://skmtc.dev/tenjin/apis/reporting-metrics-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tenjin/apis/reporting-metrics-api/revisions/cffd908625be?raw)