---
title: "auction/rounds"
method: GET
path: "/auction/rounds"
tags: ["Auction Inspection"]
---

# auction/rounds

`GET /auction/rounds`

Inspect rounds for an auction or aggregate round metrics. Requires the `auctions:read` permission.

## Query parameters

- `auction_id` string
- `start_time` integer
- `end_time` integer
- `metric` 'distribution' | 'duration' | 'cleared-on' | 'skip-reason'
- `test_mode` 'production' | 'test' | 'all'
- `app_bundle` string
- `ad_unit_id` string
- `country` string
- `device_os` 'iOS' | 'Android'
- `limit` integer

## Response `200`

Auction round rows or aggregate metrics.

- AuctionRoundsResponse
  - `rounds` AuctionRound[], required
    - `auction_id` string, required
    - `round_id` string, required
    - `round_number` integer, required
    - `priority` integer, required
    - `account_id` string, required
    - `event_time` string, required
    - `app_bundle` string, required
    - `app_name` string, required
    - `ad_unit_id` string, required
    - `device_os` string, required
    - `device_country` string, required
    - `sdk_version` string, required
    - `test_mode` boolean, required
    - `line_item_count` integer, required
    - `bidder_count` integer, required
    - `bid_count` integer, required
    - `nonbid_count` integer, required
    - `bid_sum` number, double, required
    - `has_winner` boolean, required
    - `winner_bidder` string, required
    - `winner_line_item_id` string, required
    - `winner_price_cpm` number, double, required
    - `configured_floor` number, double, required
    - `round_floor` number, double, required
    - `floor_currency` string, required
    - `dps_model` string, required
    - `dps_model_version` string, required
    - `experiment_group` string, required
    - `shadow_mode` boolean, required
    - `round_duration_ms` integer, required
  - `metrics` AuctionRoundMetric[], required
    - `metric` string, required
    - `key` string, required
    - `round_number` integer, required
    - `count` integer, required
    - `avg_duration_ms` number, double, required
    - `p50_duration_ms` number, double, required
    - `p95_duration_ms` number, double, required
    - `max_duration_ms` integer, required
    - `status` string, required
    - `nonbid_reason` integer, required
    - `error_type` string, required
    - `rejection_reason` string, required

## Other responses

- `400` — Invalid request parameters.
- `401` — Unauthorized.
- `403` — Forbidden.
- `500` — Internal server error.

---

[API](https://skmtc.dev/cloudx/apis/cloudx-api.md) · [All operations](https://skmtc.dev/cloudx/apis/cloudx-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cloudx/cloudx-api/revisions/ad78aa79d28a/schema)