---
title: "List playbook extractions"
method: GET
path: "/v2/aether/playbook/extractions"
tags: ["aether"]
---

# List playbook extractions

`GET /v2/aether/playbook/extractions`

## Request

- Base URL: `https://api.stuut.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stuut.ai/v2/aether/playbook/extractions`
- Auth: HTTP bearer

Returns extractions, optionally filtered by status.

## Query parameters

- `status` 'pending' | 'extracting' | 'deduping' | 'enriching' | 'synthesizing' | 'complete' | 'failed'

## Response `200`

Successful Response

- PlaybookExtraction[]
  - `id` string, uuid, required
  - `created_at` string, date-time, required
  - `completed_at` string, date-time, nullable, required: When processing finished
  - `created_by` string, nullable, required: User who initiated the run
  - `collection` 'cash_application' | 'collections' | 'company' | 'credit_risk' | 'deductions' | 'disputes' | 'payments', nullable, required: Target collection
  - `error` string, nullable, required: Error message if failed
  - `extraction_type` 'file' | 'onboarding' | 'synthesis', required
  - `status` 'pending' | 'extracting' | 'deduping' | 'enriching' | 'synthesizing' | 'complete' | 'failed', required
  - `dedup_count` integer, nullable, required: Items removed by dedup
  - `input_count` integer, nullable, required: Total items to process
  - `knowledge_count` integer, nullable, required: Knowledge items produced
  - `memory_count` integer, nullable, required: Memories extracted
  - `processed_count` integer, nullable, required: Sources processed so far
  - `progress` object, nullable, required: Per-stage progress
  - `proposal_count` integer, nullable, required: Proposals created
  - `file` StuutApiServiceV2RoutersAetherSchemasFileFile, required
    - `id` string, uuid, required
    - `name` string, required
    - `mime_type` string, required
    - `bucket` string, required
    - `object_key` string, required
    - `upload_url` string, nullable
    - `upload_headers` object
    - `size` integer, nullable
  - `file_id` string, uuid, nullable, required

## Other responses

- `422`: Validation Error

---

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