---
title: "List Run Scans"
method: GET
path: "/api/v1/runs/{run_id}/scans"
tags: ["runs"]
---

# List Run Scans

`GET /api/v1/runs/{run_id}/scans`

## Request

- Base URL: `https://app.kaminari.ad`
- URL: `https://app.kaminari.ad/api/v1/runs/{run_id}/scans`
- Auth: HTTP bearer

List scan tiles for a run (paginated).

``limit`` is capped at 200. Iterate via ``page``/``limit`` using
the returned ``total``/``pages`` fields.

## Path parameters

- `run_id` string, uuid, required

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

Successful Response

- PaginatedResponseScanTileResponse
  - `items` ScanTileResponse[], required
    - `id` string, uuid, required
    - `country_code` string, required
    - `status` string, required
    - `offer_url` string
    - `screenshot_url` string: Page screenshot at ?w=400 — a top-cropped tile of the capture, not the whole page. Fetch the endpoint without ?w= for the full frame.
    - `report_url` string
    - `public_report_url` string
    - `elapsed_ms` integer
    - `error` string
  - `total` integer, required
  - `page` integer, required
  - `limit` integer, required
  - `pages` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kaminari/apis/kaminari-ad-api.md) · [All operations](https://skmtc.dev/kaminari/apis/kaminari-ad-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kaminari/apis/kaminari-ad-api/revisions/013f86e2fd32?raw)