---
title: "List Signal Scans"
method: GET
path: "/v2/projects/{project_id}/runs/{run_id}/signals/scans"
tags: ["signals-v2"]
---

# List Signal Scans

`GET /v2/projects/{project_id}/runs/{run_id}/signals/scans`

## Request

- Base URL: `https://api.galileo.ai`
- URL: `https://api.galileo.ai/v2/projects/{project_id}/runs/{run_id}/signals/scans`
- Auth: one of:
  - API key in header `Splunk-AO-API-Key`
  - API key in header `Galileo-API-Key`
  - OAuth 2
    - Password
    - Token URL: `https://api.galileo.ai/login`
  - HTTP basic

List Signal scans for one log stream or experiment run, newest first.

## Path parameters

- `project_id` string, uuid4, required
- `run_id` string, uuid4, required

## Query parameters

- `cursor` string, nullable
- `limit` integer

## Response `200`

Successful Response

- SignalScanListResponse
  - `data` SignalScanSummary[], required
    - `id` string, uuid4, required
    - `scan_number` integer, required
    - `trigger` 'ON_DEMAND' | 'SCHEDULED', required: How a Signal scan starts.
    - `status` 'QUEUED' | 'RUNNING' | 'COMPLETED' | 'FAILED', required: Execution state of a Signal scan.
    - `failure_reason` string, nullable: Reason the scan failed; absent for other statuses.
    - `window_start` string, date-time, required
    - `window_end` string, date-time, required
    - `started_at` string, date-time, nullable, required
    - `completed_at` string, date-time, nullable, required
    - `eligible_session_count` integer, nullable
    - `sampled_session_count` integer, nullable
    - `analyzed_session_count` integer, nullable
    - `skipped_oversized_session_count` integer, nullable
    - `sampled_span_count` integer, nullable
    - `signals_created` integer, nullable
    - `signals_updated` integer, nullable
    - `sampling_strategy` string, nullable, required
    - `model` string, required
    - `model_usage` object, nullable, required
  - `meta` SignalScanListMeta, required
    - `next_cursor` string, nullable, required
    - `total` integer, required

## Other responses

- `422`: Validation Error

## Changes

> 34 revisions in range; 2 not diffed.

- **2026-10-14** `9a61e9b565b0`: 3 info
  - added the optional property `data/items/analyzed_session_count` to the response with the `200` status
  - added the optional property `data/items/failure_reason` to the response with the `200` status
  - added the optional property `data/items/skipped_oversized_session_count` to the response with the `200` status
- **2026-10-13** `0897291b6ee2`: 1 warning
  - removed the optional property `data/items/eligible_span_count` from the response with the `200` status
- **2026-10-03** `fede84842199`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/galileo/apis/galileo-api-server/changes/v2/projects/:project_id/runs/:run_id/signals/scans/get.md)

---

[API](https://skmtc.dev/galileo/apis/galileo-api-server.md) - [All operations](https://skmtc.dev/galileo/apis/galileo-api-server/llms.txt) - [OpenAPI document](https://skmtc.dev/galileo/apis/galileo-api-server/revisions/a289cea1b504?raw)