---
title: "Read an existing report."
method: GET
path: "/cm/v1/reports/{report_id}"
tags: ["Report"]
---

# Read an existing report.

`GET /cm/v1/reports/{report_id}`

Read an existing report.

## Path parameters

- `report_id` string, required

## Response `200`

A successful response.

- MessagesReadReportResponse
  - `report` DspReport — The metadata of a report.
    - `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)