---
title: "Get Ad Platform Logs"
method: GET
path: "/ad_platforms/{id}/lines"
---

# Get Ad Platform Logs

`GET /ad_platforms/{id}/lines`

## Path parameters

- `id` integer, required

## Query parameters

- `group_by` 'campaign' | 'adset' | 'ad'
- `granularity` 'day' | 'hour' | 'total'
- `page` integer
- `limit` integer
- `date_range[since]` union, required
  - string, date
  - string, date-time
  - string
- `date_range[until]` union
  - string, date
  - string, date-time
  - string
- `tz` string, nullable
- `start_of_week` 0 | 1
- `filters[]` string[], nullable

## Headers

- `Authorization` string, nullable
- `X-User-Id` string, nullable
- `X-Browser-Time-Zone` string, nullable

## Cookies

- `session_id` string, nullable

## Response `200`

Successful Response

- AdPlatformLinesResponse
  - `lines` AdSpendAggregatedLine[], required
    - `bucket` string, date-time, nullable
    - `channel` string
    - `campaign_id` string
    - `campaign_name` string
    - `adset_id` string, nullable
    - `adset_name` string, nullable
    - `ad_id` string, nullable
    - `ad_name` string, nullable
    - `spend` number
    - `impressions` number
    - `clicks` number
    - `conversions` number
    - `revenue` number
    - `currency` string
    - `custom_event_conversions` object
    - `custom_event_revenue` object
    - `last_updated` string, date-time, nullable
    - `campaign_url` string, nullable
    - `adset_url` string, nullable
    - `ad_url` string, nullable
  - `count` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/runconverge/apis/fastapi.md) · [All operations](https://skmtc.dev/runconverge/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/runconverge/fastapi/revisions/1452e350bd1d/schema)