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

# auction/bids

`GET /auction/bids`

List bid and non-bid rows 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
- `floor_source` 'static' | 'dynamic' | 'publisher' | 'configured'

## Response `200`

Matching bid rows.

- AuctionBidsResponse
  - `bids` AuctionBid[], required
    - `auction_id` string, required
    - `account_id` string, required
    - `event_time` string, required
    - `bidder` string, required
    - `bid_id` string, required
    - `imp_id` string, required
    - `price_cpm` number, double, required
    - `deal_id` string, required
    - `is_winner` boolean, required
    - `app_bundle` string, required
    - `ad_unit_id` string, required
    - `device_os` string, required
    - `device_country` string, required
    - `sdk_version` string, required
    - `test_mode` boolean, required
    - `status` string, required
    - `nonbid_reason` integer, required
    - `static_floor` number, double, required
    - `configured_floor` number, double, required
    - `dynamic_floor` number, double, required
    - `publisher_floor` number, double, required
    - `publisher_floor_applied` boolean, required
    - `effective_floor` number, double, required
    - `effective_floor_source` string, required
    - `publisher_override_active` boolean, required
    - `http_status` integer, required
    - `latency_ms` integer, required
    - `error_type` string, required
    - `rejection_reason` string, required
    - `round_number` integer, required
    - `priority` integer, required
    - `inserted_at` 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)