---
title: "List Clicks"
method: GET
path: "/v1/reporting/clicks"
tags: ["v1"]
---

# List Clicks

`GET /v1/reporting/clicks`

List affiliate clicks for your account over a datetime window.

Defaults to the last 30 days ending now. Maximum window is 90 days.
Pass an offset-aware ISO datetime to express local time (e.g. last 6 hours).
Returns a summary plus a paginated list of click events (most recent first).

## Query parameters

- `start_date` string, date-time, nullable — Inclusive start of the window (ISO 8601 datetime with optional offset, e.g. 2026-08-01T00:00:00-04:00). Offset-aware values are converted to UTC; naive values are treated as UTC.
- `end_date` string, date-time, nullable — Inclusive end of the window (ISO 8601 datetime with optional offset, e.g. 2026-08-01T23:59:59-04:00). Offset-aware values are converted to UTC; naive values are treated as UTC.
- `page` integer — Page number (1-indexed).
- `limit` integer — Items per page (max 100).

## Response `200`

Successful Response

- ClicksResponse — Paginated clicks for a vendor over a date range.
  - `summary` ClicksSummary, required — Aggregate click stats for the requested date range.
    - `total_clicks` integer, required — Total clicks in the date range.
  - `items` Click[], required
    - `id` string, required — Click event ID.
    - `timestamp` string, date-time, required — When the click occurred, returned with a UTC offset (Z).
    - `product` AffiliateProduct — Compact product reference on click/transaction items.
      - `id` string, required — Canonical product ID.
      - `title` string, nullable — Product title.
      - `image_url` string, nullable — Product image URL.
    - `city` string, nullable — Click city, if available.
    - `country` string, nullable — Click country, if available.
  - `page` integer, required — Current page (1-indexed).
  - `limit` integer, required — Page size.
  - `total_count` integer, required — Total matching clicks in the date range.
  - `has_more` boolean, required — Whether more pages are available.
  - `start_date` string, date-time, required — Inclusive start of the resolved query window.
  - `end_date` string, date-time, required — Inclusive end of the resolved query window.

## Other responses

- `400` — Invalid date range
- `401` — Unauthorized - Invalid or missing authentication
- `402` — Payment required
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/channel3-ai/apis/fastapi.md) · [All operations](https://skmtc.net/channel3-ai/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/channel3-ai/fastapi/versions/981d371bd83e/schema)