---
title: "List ownership recoveries"
method: GET
path: "/workspace/recoveries"
tags: ["workspace"]
---

# List ownership recoveries

`GET /workspace/recoveries`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/workspace/recoveries`
- Auth: HTTP bearer

Lists the workspace's ownership recoveries, newest first, and whether the caller may ask for one: an officer or a director on record who isn't an owner, while none is pending.

## Response `200`

The result.

- object
  - `recoveries` object[], required
    - `id` string, required
    - `status` 'pending' | 'cancelled' | 'completed', required
    - `requested_by` string, required
    - `requested_by_member_id` string, required
    - `new_owner` string, required
    - `new_owner_member_id` string, required
    - `document_id` string, required
    - `reason` string, required
    - `notice_sent_at` string, date-time, nullable, required
    - `effective_after` string, date-time, nullable, required
    - `checked_by` string, nullable, required
    - `checked_at` string, date-time, nullable, required
    - `cancelled_by` string, nullable, required
    - `cancelled_at` string, date-time, nullable, required
    - `completed_at` string, date-time, nullable, required
    - `can_cancel` boolean, required
    - `created_at` string, date-time, required
  - `can_request` boolean, required

## Other responses

- `default`: An RFC 9457 problem.

---

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