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

# auction/list

`GET /auction/list`

List recent auctions matching the requested filters. Requires the `auctions:read` permission.

## Query parameters

- `start_time` integer, required
- `end_time` integer, required
- `test_mode` 'production' | 'test' | 'all'
- `app_bundle` string
- `ad_unit_id` string
- `country` string
- `device_os` 'iOS' | 'Android'
- `limit` integer
- `has_ilrd` boolean
- `has_external_ilrd` boolean
- `mediator` 'applovin' | 'admob' | 'levelplay'

## Response `200`

Matching auctions.

- AuctionListResponse
  - `auctions` AuctionListItem[], required
    - `auction_id` string, required
    - `account_id` string, required
    - `event_time` string, required
    - `app_bundle` string, required
    - `app_name` string, required
    - `ad_unit_id` string, required
    - `imp_count` integer, required
    - `device_os` string, required
    - `device_country` string, required
    - `sdk_version` string, required
    - `test_mode` boolean, required
    - `status` integer, required
    - `priority` integer, required
    - `has_winner` boolean, required
    - `winner_bidder` string, required
    - `winner_price_cpm` number, double, required
    - `bidder_count` integer, required
    - `bid_count` integer, required
    - `nonbid_count` integer, required
    - `auction_duration_ms` integer, required
    - `error` string, required
    - `ab_test_id` string, required
    - `ab_test_variant` string, required
    - `inserted_at` string, required
    - `has_ilrd` boolean, required
    - `has_external_ilrd` boolean, required
    - `external_ilrd_count` integer, required
    - `external_revenue` number, double, required
    - `external_mediators` 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)