---
title: "Get scan status"
method: GET
path: "/scans/{dir}/{scan}"
tags: ["scans"]
---

# Get scan status

`GET /scans/{dir}/{scan}`

Returns detailed status and metadata for a single scan. Send Accept: application/zip to download the scan directory as a zip archive.

## Path parameters

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

## Response `200`

Successful Response

- Status — Status of scan job.
  - `complete` boolean, required
  - `errors` Error[], required
    - `error` string, required
    - `refusal` boolean, required
    - `scanner` string, required
    - `traceback` string, required
    - `transcript_id` string, required
  - `location` string, required
  - `spec` ScanSpec, required — Scan specification (scanners, transcripts, config).
    - `metadata` object, nullable
    - `model` ModelConfigOutput — Model config.
      - `args` object, required
      - `base_url` string, nullable
      - `config` GenerateConfigOutput, required — Model generation options.
        - `adaptive_connections` union
          - boolean
          - integer
          - AdaptiveConcurrency — Bounds and tuning for an adaptive concurrency controller. Basic fields (`min`, `start`, `max`) bound the range the controller will scale within. Advanced fields (`cooldown_seconds`, `decrease_factor`, `scale_up_percent`) tune the response curve and have sensible defaults for typical evaluation workloads — see the parallelism docs for guidance. Accepts a string shorthand ("min-max" or "min-start-max") for use in CLI flags and config files; advanced fields are Python-only.
            - `cooldown_seconds` number, required
            - `decrease_factor` number, required
            - `max` integer, required
            - `min` integer, required
            - `scale_up_percent` number, required
            - `start` integer, required
        - `attempt_timeout` integer, nullable
        - `batch` union
          - boolean
          - integer
          - BatchConfig — Batch processing configuration.
            - `max_batches` integer, nullable
            - `max_consecutive_check_failures` integer, nullable
            - `max_size` integer, nullable
            - `send_delay` number, nullable
            - `size` integer, nullable
            - `tick` number, nullable
        - `best_of` integer, nullable
        - `cache` union
          - boolean
          - CachePolicy — Caching options for model generation.
            - `expiry` string, nullable
            - `per_epoch` boolean, required
            - `scopes` object, required
        - `cache_prompt` union
          - 'auto'
          - boolean
        - `effort` 'low' | 'medium' | 'high' | 'xhigh' | 'max', nullable
        - `extra_body` object, nullable
        - `extra_headers` object, nullable
        - `fallback_models` string[], nullable
        - `frequency_penalty` number, nullable
        - `internal_tools` boolean, nullable
        - `logit_bias` object, nullable
        - `logprobs` boolean, nullable
        - `max_connections` integer, nullable
        - `max_retries` integer, nullable
        - `max_tokens` integer, nullable
        - `max_tool_output` integer, nullable
        - `modalities` union[], nullable
          - union
            - 'image'
            - ImageOutput — Image output configuration. Use the `options` field to pass provider-specific options directly to the underlying API (e.g. OpenAI image_generation tool parameters).
              - …
        - `num_choices` integer, nullable
        - `parallel_tool_calls` boolean, nullable
        - `presence_penalty` number, nullable
        - `prompt_logprobs` integer, nullable
        - `reasoning_effort` 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max', nullable
        - `reasoning_history` 'none' | 'all' | 'last' | 'auto', nullable
        - `reasoning_mode` 'standard' | 'pro', nullable
        - `reasoning_summary` 'none' | 'concise' | 'detailed' | 'auto', nullable
        - `reasoning_tokens` integer, nullable
        - `response_schema` ResponseSchemaOutput — Schema for model response when using Structured Output.
          - `description` string, nullable
          - `json_schema` JSONSchemaOutput, required — JSON Schema for type.
            - `additionalProperties` union
              - …
            - `anyOf` JSONSchemaOutput[], nullable
            - `default` unknown, required
            - `description` string, nullable
            - `enum` unknown[], nullable
              - …
            - `examples` unknown[], nullable
              - …
            - `format` string, nullable
            - `items` JSONSchemaOutput — recursive
            - `maxLength` integer, nullable
            - `maximum` union
              - …
            - `minLength` integer, nullable
            - `minimum` union
              - …
            - `pattern` string, nullable
            - `properties` object, nullable
            - `required` string[], nullable
            - `type` union
              - …
          - `name` string, required
          - `strict` boolean, nullable
        - `seed` integer, nullable
        - `stop_seqs` string[], nullable
        - `system_message` string, nullable
        - `temperature` number, nullable
        - `timeout` integer, nullable
        - `top_k` integer, nullable
        - `top_logprobs` integer, nullable
        - `top_p` number, nullable
        - `verbosity` 'low' | 'medium' | 'high', nullable
      - `model` string, required
    - `model_roles` object, nullable
    - `options` ScanOptions, required — Options used for scan.
      - `limit` integer, nullable
      - `max_processes` integer, nullable
      - `max_transcripts` integer, required
      - `results_buffer` integer, nullable
      - `shuffle` union
        - boolean
        - integer
    - `packages` object, required
    - `revision` ScanRevision — Git revision for scan.
      - `commit` string, required
      - `origin` string, required
      - `type` 'git', required
      - `version` string, required
    - `scan_args` object, nullable
    - `scan_file` string, nullable
    - `scan_id` string, required
    - `scan_name` string, required
    - `scanners` object, required
    - `tags` string[], nullable
    - `timestamp` string, required
    - `transcripts` ScanTranscripts — Transcripts targeted by a scan.
      - `count` integer, required
      - `data` string, nullable
      - `fields` TranscriptField[], nullable
        - `name` string, required
        - `type` string, required
        - `tz` string, required
      - `filter` string[], nullable
      - `location` string, nullable
      - `transcript_ids` object, required
      - `type` 'eval_log' | 'database', required
    - `validation` object, nullable
    - `worklist` Worklist[], nullable
      - `scanner` string, required
      - `transcripts` string[], required
  - `summary` Summary, required — Summary of scan results.
    - `complete` boolean, required
    - `scanners` object, 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)