---
title: "Record Recovery"
method: POST
path: "/v1/matters/{matter_id}/cash-book/dividends/{run_id}/recoveries"
tags: ["cash-book"]
---

# Record Recovery

`POST /v1/matters/{matter_id}/cash-book/dividends/{run_id}/recoveries`

## Request

- Base URL: `https://api.ender.au` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ender.au/v1/matters/{matter_id}/cash-book/dividends/{run_id}/recoveries`
- Auth: HTTP bearer

## Path parameters

- `run_id` string, uuid, required
- `matter_id` string, uuid, required

## Headers

- `Idempotency-Key` string, required

## Request body

- RecordRecovery: A creditor repaying what earlier schedules overpaid it (reg 5.6.55).
  - `creditor_id` string, uuid, required
  - `bank_account_id` string, uuid, required
  - `received_on` string, date, required
  - `amount` string, decimal, required
  - `reference` string, nullable

## Response `201`

Successful Response

- RecoveryRecorded
  - `transaction_id` string, uuid, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ender/apis/ender-backend.md) - [All operations](https://skmtc.dev/ender/apis/ender-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/ender/apis/ender-backend/revisions/bf4373130521?raw)