---
title: "Batch Status"
method: GET
path: "/workspaces/{wid}/retention/batches/{bid}/status"
tags: ["retention"]
---

# Batch Status

`GET /workspaces/{wid}/retention/batches/{bid}/status`

## 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}/retention/batches/{bid}/status`
- Auth: none declared

One batch's file deletion state, for any member of the workspace.

## Path parameters

- `wid` string, uuid, required
- `bid` string, uuid, required

## Response `200`

Successful Response

- BatchRetentionStatus
  - `deletion_state` 'off' | 'paused' | 'scheduled' | 'due' | 'deleting' | 'deleted', required
  - `retention_days` integer, required
  - `deletes_on` string, date-time, nullable, required
  - `deleted_at` string, date-time, nullable, required
  - `kept_until` string, date-time, nullable, 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)