---
title: "Get Scouts"
method: GET
path: "/v1/scouting/tasks"
tags: ["Scouting"]
---

# Get Scouts

`GET /v1/scouting/tasks`

List scouting tasks for this user.

## Query parameters

- `status` 'active' | 'paused' | 'done', nullable — Filter by scout status
- `page_size` integer, nullable
- `cursor` string, nullable

## Response `200`

Successful Response

- ScoutListResponse
  - `scouts` ScoutListItem[], required
    - `id` string, uuid, required
    - `query` string, required
    - `display_name` string, required
    - `status` 'active' | 'paused' | 'done', required
    - `created_at` string, date-time, required
    - `next_output_timestamp` string, date-time, nullable, required
    - `output_interval` integer, required — Run interval in seconds
    - `rejection_reason` 'insufficient_prepaid_balance' | 'budget_exceeded' | 'subscription_inactive'
  - `total` integer — Total count of all scouts (active + paused + done)
  - `filtered_total` integer — Count of scouts matching the current filter
  - `summary` ScoutsSummary — Summary counts of scouts by status.
    - `active` integer, required — Number of active scouts
    - `paused` integer, required — Number of paused scouts
    - `done` integer, required — Number of completed scouts
  - `page_size` integer, nullable — Requested page size (null if returning all)
  - `has_more` boolean — Whether more results exist after this page
  - `prev_cursor` string, nullable — Cursor for previous page
  - `next_cursor` string, nullable — Cursor for next page

## Other responses

- `422` — Validation Error

---

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