---
title: "List up reports."
method: GET
path: "/cm/v1/reports"
tags: ["Report"]
---

# List up reports.

`GET /cm/v1/reports`

List up reports in the given Workplace and AdAccount.

## Query parameters

- `ad_account_id` string, required

## Response `200`

A successful response.

- MessagesListReportsResponse
  - `reports` DspReport[] — List of reports in the given Workplace and AdAccount.
    - `id` string — Unique identifier of the Report. Automatically set by server on creation.
    - `ad_account_id` string, required — Ad account ID to which the report associated.
    - `product_id` string — Product App or Site ID to which the report associated.
    - `date_range` AdcloudcommonDateInterval, required — Interval with start and end dates in the format of YYYY-MM-DD.
      - `start` string — Start date in the format of YYYY-MM-DD.
      - `end` string — End date in the format of YYYY-MM-DD.
    - `dimensions` DspReportDimension[], required — List of interested dimensions by which metric numbers will be broken down.
    - `optional_metrics` ReportOptionalMetric[] — List of interested optional metrics.
    - `expire_at` string, date-time — The time when a report will be expired.
    - `created_at` string, date-time — Created time.
    - `updated_at` string, date-time — Last updated time. Should not modify on the client side.

## Other responses

- `default` — Error. Detailed cause can be found in the `details` field.

---

[API](https://skmtc.net/moloco/apis/moloco-ads-campaign-management-api.md) · [All operations](https://skmtc.net/moloco/apis/moloco-ads-campaign-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/moloco/moloco-ads-campaign-management-api/revisions/5c85d0910ac0/schema)