---
title: "List Scans"
method: GET
path: "/chat/workspace-scans"
tags: ["workspace scans"]
---

# List Scans

`GET /chat/workspace-scans`

## Query parameters

- `integration_id` string, uuid, required — Chat integration to list scans for.

## Response `200`

Successful Response

- ListWorkspaceScansResponse
  - `scans` APIApiSchemaChatWorkspaceScansChatWorkspaceScan[], required
    - `id` string, uuid, required
    - `organization_id` string, uuid, required
    - `integration_id` string, uuid, required
    - `started_by_user_id` string, uuid, required
    - `status` 'pending' | 'running' | 'partial' | 'completed' | 'failed', required
    - `stage` 'resolving_integration' | 'preparing_inventory' | 'selecting_candidates' | 'analyzing' | 'finalizing' | 'ready', required
    - `deadline_at` string, date-time, required
    - `inventory_refreshed_at` string, date-time, nullable, required
    - `progress` WorkspaceScanProgress, required
      - `schema_version` integer, required
      - `channels_discovered` integer, required
      - `channels_eligible` integer, required
      - `channels_enriched` integer, required
    - `error_code` string, nullable, required
    - `error_message` string, nullable, required
    - `revision` integer, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `completed_at` string, date-time, nullable, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/traversal/apis/fastapi.md) · [All operations](https://skmtc.dev/traversal/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/traversal/fastapi/revisions/01ca496f3b4f/schema)