---
title: "List scans"
method: POST
path: "/scans/{dir}"
tags: ["scans"]
---

# List scans

`POST /scans/{dir}`

Returns scans from specified directory. Optional filter condition uses SQL-like DSL. Optional order_by for sorting results. Optional pagination for cursor-based pagination.

## Path parameters

- `dir` string, required — Scans directory (base64url-encoded)

## Request body

- ScansRequest — Request body for POST /scans endpoint.
  - `filter` Condition — WHERE clause condition that can be combined with others.
    - `is_compound` boolean, required
    - `left` union
      - string
      - Condition — recursive
    - `operator` union
      - '=' | '!=' | '<' | '<=' | '>' | '>=' | 'IN' | 'NOT IN' | 'LIKE' | 'NOT LIKE' | 'ILIKE' | 'NOT ILIKE' | 'IS NULL' | 'IS NOT NULL' | 'BETWEEN' | 'NOT BETWEEN' — SQL comparison operators.
      - 'AND' | 'OR' | 'NOT' — Logical operators for combining conditions.
    - `right` union
      - Condition — recursive
      - union[]
        - union
          - string
          - integer
          - number
          - boolean
          - string, date-time
          - string, date
      - string
      - integer
      - number
      - boolean
      - string, date-time
      - string, date
  - `order_by` union
    - OrderBy
      - `column` string, required
      - `direction` 'ASC' | 'DESC', required
    - OrderBy[]
      - `column` string, required
      - `direction` 'ASC' | 'DESC', required
  - `pagination` Pagination
    - `cursor` object, nullable
    - `direction` 'forward' | 'backward', required
    - `limit` integer, required

## Response `200`

Successful Response

- ScansResponse — Response body for POST /scans endpoint.
  - `items` ScanRow[], required
    - `active_completion_pct` integer, nullable
    - `location` string, required
    - `metadata` object, nullable
    - `model` string, nullable
    - `packages` object, required
    - `revision_commit` string, nullable
    - `revision_origin` string, nullable
    - `revision_version` string, nullable
    - `scan_args` object, nullable
    - `scan_file` string, nullable
    - `scan_id` string, required
    - `scan_name` string, required
    - `scanners` string, required
    - `status` 'active' | 'error' | 'complete' | 'incomplete', required
    - `tags` string, required
    - `timestamp` string, date-time, required
    - `total_errors` integer, required
    - `total_results` integer, required
    - `total_tokens` integer, required
    - `transcript_count` integer, required
  - `next_cursor` object, nullable
  - `total_count` integer, required

---

[API](https://skmtc.net/meridianlabs-ai/apis/inspect-scout-viewer-api.md) · [All operations](https://skmtc.net/meridianlabs-ai/apis/inspect-scout-viewer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/meridianlabs-ai/inspect-scout-viewer-api/revisions/80dc9ada6cd6/schema)