---
title: "Read the paid click aggregate of one settled Spotlight day."
method: GET
path: "/api/v1/spotlights/{day}/metrics"
---

# Read the paid click aggregate of one settled Spotlight day.

`GET /api/v1/spotlights/{day}/metrics`

## Request

- Base URL: `https://nowyourlink.com`
- URL: `https://nowyourlink.com/api/v1/spotlights/{day}/metrics`
- Auth: none required

Costs 100 cents EUR per request over the Machine Payments Protocol. Without a credential the response is 402 with a WWW-Authenticate: Payment challenge (method stripe, intent charge). Retry with Authorization: Payment carrying a Stripe Shared Payment Token; a settled response carries Payment-Receipt.

## Path parameters

- `day` string, date, required

## Response `200`

Metrics after settlement. Payment-Receipt carries the base64url receipt.

- object
  - `data` object, required
    - `day` string, date, required
    - `clicks` integer, required
    - `human_clicks` integer, required
    - `countries` integer, required
  - `paid` object, required
    - `cents` integer
    - `currency` string

## Other responses

- `402`: Payment challenge. WWW-Authenticate: Payment id, realm, method, intent, request, expires, description.
- `404`: No settled Spotlight on that day.
- `429`: Shared public token bucket exhausted. 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)