---
title: "GET /v1/scans"
method: GET
path: "/v1/scans"
---

# GET /v1/scans

`GET /v1/scans`

## Query parameters

- `customerId` string, uuid, required
- `stage` 'ingestion' | 'dewarping' | 'classification' | 'measurement' | 'qa'
- `stageStatus` 'pending' | 'running' | 'succeeded' | 'failed' | 'skipped' | 'rejected'
- `activity` string
- `position` string
- `capturedAfter` string, date-time
- `capturedBefore` string, date-time
- `limit` integer
- `offset` integer

## Response `200`

Default Response

## Changes

- **2026-09-16** `5260c627c7e6` — 2 info
  - added the new optional `query` request parameter `activity`
  - added the new optional `query` request parameter `position`

[Change history](https://skmtc.dev/transload/apis/pipeline-backend/changes/v1/scans/get.md)

---

[API](https://skmtc.dev/transload/apis/pipeline-backend.md) · [All operations](https://skmtc.dev/transload/apis/pipeline-backend/llms.txt) · [OpenAPI document](https://skmtc.dev/transload/apis/pipeline-backend/revisions/19339551d148?raw)