---
title: "Get Ad Platform Runs"
method: GET
path: "/ad_platforms/{id}/runs"
---

# Get Ad Platform Runs

`GET /ad_platforms/{id}/runs`

## Path parameters

- `id` integer, required

## Query parameters

- `type` 'ad_spend' | 'ad_metadata'
- `limit` integer
- `page` integer

## Headers

- `Authorization` string, nullable
- `X-User-Id` string, nullable

## Cookies

- `session_id` string, nullable

## Response `200`

Successful Response

- AdPlatformRunsResponseSchema
  - `ad_platform_runs` AdPlatformRunResponseSchema[], required
    - `id` integer, required
    - `ad_platform_id` integer, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `type` 'ad_spend' | 'ad_metadata'
    - `status` 'starting' | 'running' | 'healthy' | 'unhealthy' | 'deferred' | 'cancelled'
    - `pulled_since` string, date-time, nullable
    - `pulled_until` string, date-time, nullable
    - `lines` integer, nullable
    - `version` integer, nullable
    - `progress` number, nullable
    - `sync_start` string, date-time, nullable
    - `sync_end` string, date-time, nullable
    - `job_id` integer, nullable
    - `task_id` integer, nullable
    - `failure` AdSpendPullerFailure
      - `type` 'authentication_error' | 'connection_error' | 'response_error' | 'configuration_error' | 'unknown_error' | 'invalid_ad', required
      - `description` string, nullable
      - `status_code` union
        - integer
        - string
      - `message` 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)