---
title: "List scans"
method: GET
path: "/api/scans"
tags: ["scans"]
---

# List scans

`GET /api/scans`

List scan history with pagination and optional status filtering.

## Query parameters

- `page` integer
- `per_page` integer
- `status_filter` 'PENDING' | 'INITIALIZING' | 'RUNNING' | 'PAUSED' | 'COMPLETED' | 'STOPPED' | 'FAILED' — Scan lifecycle status

## Response `200`

Paginated scan list

- ScanListResponse
  - `scans` ScanSummary[]
    - `scan_id` integer
    - `target` string
    - `status` 'PENDING' | 'INITIALIZING' | 'RUNNING' | 'PAUSED' | 'COMPLETED' | 'STOPPED' | 'FAILED' — Scan lifecycle status
    - `progress` integer
    - `timestamp` string, date-time
    - `origin` 'cli' | 'web' | 'unknown'
    - `has_report` boolean
  - `total` integer
  - `page` integer
  - `per_page` integer

## Other responses

- `400` — Invalid pagination parameters

---

[API](https://skmtc.net/bugtraceai/apis/bugtraceai-cli-api.md) · [All operations](https://skmtc.net/bugtraceai/apis/bugtraceai-cli-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bugtraceai/bugtraceai-cli-api/versions/312bfc1148dc/schema)