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

# List up logs.

`GET /cm/v1/logs`

List up logs in the given Workplace.

## Query parameters

- `ad_account_id` string, required
- `date_range.start` string, required
- `date_range.end` string, required

## Response `200`

Successfully listed up the logs.

- MessagesListLogsResponse
  - `logs` DspLog[] — List of logs in the given Workplace.
    - `id` string — Unique identifier of the Log. Automatically set by server on creation.
    - `type` 'UNKNOWN_LOG_TYPE' | 'IMP' | 'CLICK' | 'CONVERSION' | 'SKAN_CONVERSION' | 'ENGAGED_VIEW', required — Type enumerates available log types. Unknown log type. - IMP: Log type which includes every impression log. - CLICK: Log type which includes every click log. - CONVERSION: Log type which includes every conversion event log. - SKAN_CONVERSION: Log type which includes SKAdNetwork attributed conversion event log. - ENGAGED_VIEW: Log type which includes every engaged view log.
    - `format` 'UNKNOWN_LOG_FORMAT' | 'CSV' | 'AVRO' | 'PARQUET' — Format enumerates the format of log. Default is CSV. - CSV: CSV format. - AVRO: Avro format. - PARQUET: Parquet format.
    - `date` string, required — Date for which a log contains the data in "yyyy-mm-dd" format.
    - `ad_account_id` string, required — Ad account ID to which the log is bound.
    - `status` 'UNKNOWN_LOG_STATUS' | 'ACCEPTED' | 'READY' | 'FAILED' — Status enumerates the status of log. - ACCEPTED: Successfully initiated the log generation request. - READY: Successfully generated the log. It's ready to download from the location. - FAILED: Failed to generate the log. Reasons of failure can be found at errors.
    - `skip_compression` boolean — Flag whether to skip compression.
    - `expire_at` string, date-time — The time when a log 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` — An unexpected error response.

---

[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)