---
title: "Read 1–10 public settled days in one request. Missing or removed days return per-item 404; input order is preserved."
method: GET
path: "/api/v1/spotlights/batch"
---

# Read 1–10 public settled days in one request. Missing or removed days return per-item 404; input order is preserved.

`GET /api/v1/spotlights/batch`

## Request

- Base URL: `https://nowyourlink.com`
- URL: `https://nowyourlink.com/api/v1/spotlights/batch`
- Auth: none required

Read 1–10 public settled days in one request. Missing or removed days return per-item 404; input order is preserved.

## Query parameters

- `days` string, required

## Response `200`

Successful public read.

- object
  - `results` object[], required
    - `day` string, date, required: Settled auction date in UTC, YYYY-MM-DD.
    - `status` 200 | 404, required
    - `data` object, nullable, required
      - `day` string, date, required: Settled auction date in UTC, YYYY-MM-DD.
      - `headline` string, required
      - `description` string, required
      - `advertiser` string, required
      - `canonicalUrl` string, uri, required
      - `contentType` 'paid_advertisement' | 'house_advertisement', required

## Other responses

- `400`: Invalid input, unavailable content, or temporary service failure. See problem detail.
- `404`: Invalid input, unavailable content, or temporary service failure. See problem detail.
- `429`: Shared public token bucket exhausted. Wait Retry-After seconds before retrying.
- `503`: Invalid input, unavailable content, or temporary service failure. See problem detail.

---

[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)