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

# Get Ad Platform Logs

`GET /ad_platforms/{id}/lines`

## Request

- Base URL: `https://app.runconverge.com/api`
- URL: `https://app.runconverge.com/api/ad_platforms/{id}/lines`
- Auth: none declared

## 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/runconverge-api.md) - [All operations](https://skmtc.dev/runconverge/apis/runconverge-api/llms.txt) - [OpenAPI document](https://skmtc.dev/runconverge/apis/runconverge-api/revisions/f723e951cc0b?raw)