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

# Get Scouts

`GET /v1/scouting/tasks`

## Request

- Base URL: `https://api.yutori.com`
- URL: `https://api.yutori.com/v1/scouting/tasks`
- Auth: API key in header `x-api-key`

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/yutori-api.md) - [All operations](https://skmtc.dev/yutori/apis/yutori-api/llms.txt) - [OpenAPI document](https://skmtc.dev/yutori/apis/yutori-api/revisions/ef669f82d5bc?raw)