---
title: "Listing"
method: GET
path: "/workspaces/{wid}/batches"
tags: ["documents"]
---

# Listing

`GET /workspaces/{wid}/batches`

## Request

- Base URL: `https://app.linerecon.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.linerecon.com/workspaces/{wid}/batches`
- Auth: none declared

## Path parameters

- `wid` string, uuid, required

## Query parameters

- `limit` integer
- `sort` 'last_activity' | 'created_at' | 'name'
- `order` 'asc' | 'desc', nullable
- `q` string, nullable
- `stage` string[], nullable
- `segment` 'all' | 'needs_you' | 'processing' | 'done'
- `cursor` string, nullable

## Response `200`

Successful Response

- BatchList
  - `items` BatchListItem[], required
    - `created_at` string, date-time, required
    - `created_by` string, uuid, required
    - `created_by_name` string, nullable, required
    - `last_activity_at` string, date-time, required
    - `file_count` integer, required
    - `page_count` integer, required
    - `usable_file_count` integer, required
    - `usable_page_count` integer, required
    - `pending_file_count` integer, required
    - `preparation_stage` 'intake' | 'plan' | 'processing' | 'review', required
    - `stage` 'upload' | 'plan' | 'processing' | 'paused' | 'review' | 'export' | 'done', required
    - `segment` 'needs_you' | 'processing' | 'done', required
    - `id` string, uuid, required
    - `name` string, required
    - `state` string, required
    - `schema_revision` integer, required
    - `confirmed_schema_version_id` string, uuid, nullable, required
    - `review_mode` 'standard' | 'strict', required
    - `workflow` WorkflowSummary, required
      - `processing` ProcessingSummary, required
        - `state` string, required
        - `latest_run_id` string, uuid, nullable, required
        - `latest_run_status` string, nullable, required
        - `latest_run_purpose` string, nullable, required
        - `pause_reason` string, nullable, required
      - `review` HumanWorkSummary, required
        - `open_count` integer, required
        - `to_pair_count` integer, required
        - `accepted_count` integer, required
        - `consistent_count` integer, required
        - `disputed_count` integer, required
        - `comparison_version_id` string, uuid, nullable, required
        - `comparison_version` integer, nullable, required
        - `current` boolean, required
        - `mode` 'standard' | 'strict', required
        - `revision` integer, required
        - `finding_count` integer, required
        - `system_consistent_count` integer, required
        - `human_reviewed_count` integer, required
        - `follow_up_count` integer, required
        - `unpaired_records` integer, nullable, required
        - `unpublished_pages` integer, nullable, required
        - `unresolved_documents` integer, nullable, required
        - `coverage_unknown` boolean, required
      - `report` ReportSummary, required
        - `state` 'not_requested' | 'current_snapshot' | 'earlier_snapshot', required
        - `latest_export_id` string, uuid, nullable, required
        - `comparison_version_id` string, uuid, nullable, required
        - `review_revision` integer, nullable, required
    - `file_deletion` FileDeletion, required: Automatic deletion has claimed the batch's files: `deleting` (no longer readable; the bytes are being removed) or `deleted` on `deleted_at`.
      - `status` 'deleting' | 'deleted', required
      - `deleted_at` string, date-time, nullable, required
  - `next_cursor` string, nullable, required
  - `segment_counts` SegmentCounts, required
    - `all` integer, required
    - `needs_you` integer, required
    - `processing` integer, required
    - `done` integer, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `413`: Content Too Large
- `422`: Unprocessable Content
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/linerecon/apis/linerecon-api.md) · [All operations](https://skmtc.dev/linerecon/apis/linerecon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/linerecon/apis/linerecon-api/revisions/0650f53a4249?raw)