---
title: "List this advertiser's bids for one auction day."
method: GET
path: "/v1/agent/bids"
---

# List this advertiser's bids for one auction day.

`GET /v1/agent/bids`

## Request

- Base URL: `https://api.nowyourlink.com`
- URL: `https://api.nowyourlink.com/v1/agent/bids`
- Auth: OAuth 2 (authorization code, authorization URL `https://api.nowyourlink.com/oauth/authorize`, token URL `https://api.nowyourlink.com/oauth/token`, scopes: `bids:read`)

List this advertiser's bids for one auction day.

## Query parameters

- `day` string, date, required: Settled auction date in UTC, YYYY-MM-DD.

## Response `200`

The advertiser's bids for the day.

- object
  - `bids` object[], required
    - `id` string, required
    - `day` string, date, required: Settled auction date in UTC, YYYY-MM-DD.
    - `ad_id` string, nullable, required
    - `amount_cents` integer, required
    - `currency` 'EUR', required
    - `status` string, required
    - `placed_at` string, date-time, required

## Other responses

- `400`: day=YYYY-MM-DD is required.
- `401`: The bearer token is missing, expired or invalid. A missing Authorization header returns an empty body.
- `403`: This grant lacks the scope the operation requires.
- `405`: The path exists but does not accept this method (agent.method-not-allowed).
- `429`: This grant's 120-per-minute token bucket is empty. Wait Retry-After seconds before retrying.

---

[API](https://skmtc.dev/nowyourlink/apis/nowyourlink-public-spotlight-api.md) · [All operations](https://skmtc.dev/nowyourlink/apis/nowyourlink-public-spotlight-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nowyourlink/apis/nowyourlink-public-spotlight-api/revisions/cd8408529b48?raw)