---
title: "Save Report"
method: POST
path: "/v1/matters/{matter_id}/cash-book/reports/history"
tags: ["cash-book"]
---

# Save Report

`POST /v1/matters/{matter_id}/cash-book/reports/history`

## 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/reports/history`
- Auth: HTTP bearer

## Path parameters

- `matter_id` string, uuid, required

## Headers

- `Idempotency-Key` string, required

## Request body

- SaveReportInput
  - `bank_account_id` string, uuid, nullable
  - `start` string, date, nullable
  - `end` string, date, nullable
  - `view` 'summary' | 'ledger' | 'detailed' | 'trial-balance'
  - `name` string, required
  - `note` string, nullable

## Response `200`

Successful Response

- IssuedReport
  - `id` string, uuid, required
  - `selection` ReportSelection, required
    - `bank_account_id` string, uuid, nullable, required
    - `start` string, date, nullable, required
    - `end` string, date, nullable, required
    - `view` 'summary' | 'ledger' | 'detailed' | 'trial-balance', required
  - `created_at` string, date-time, required
  - `created_by` string, uuid, required
  - `created_by_name` string, required
  - `bank_names` string[], required
  - `version` integer, required
  - `name` string, nullable, required
  - `note` string, nullable, required
  - `snapshot` ReportsPage, required
    - `lines` ReportLine[], required
      - `id` string, uuid, required
      - `code` string, required
      - `name` string, required
      - `receipts` string, required
      - `payments` string, required
      - `debit` string, required
      - `credit` string, required
    - `receipts` string, required
    - `payments` string, required
    - `receipts_gst_component` string, required
    - `payments_gst_component` string, required
    - `opening_balance` string, required
    - `closing_balance` string, required
    - `details` RpDetail[], required
      - `id` string, required
      - `transaction_id` string, uuid, required
      - `bank_account_id` string, uuid, nullable, required
      - `bank_name` string, required
      - `no_bank_movement` boolean, required
      - `date` string, date, required
      - `reference` string, nullable, required
      - `narration` string, required
      - `counterparty` string, nullable, required
      - `category` string, required
      - `asic_parent` string, nullable, required
      - `account_code` string, required
      - `account_name` string, required
      - `asset_pool` string, nullable, required
      - `direction` 'receipt' | 'payment', required
      - `gross` string, required
      - `gst` string, required
      - `invoice_gst` string, nullable, required
      - `net` string, required
      - `document_ids` string[], required
      - `document_names` object, required
    - `summary` RpSummary[], required
      - `category` string, required
      - `receipts` string, required
      - `payments` string, required
      - `receipts_gst_component` string, required
      - `payments_gst_component` string, required
      - `count` integer, required
    - `external_receipts` string, required
    - `external_payments` string, required
    - `transfer_receipts` string, required
    - `transfer_payments` string, required
    - `opening_balance_additions` string, required
    - `matter_name` string, required
    - `bank_names` string[], required
    - `start` string, date, nullable, required
    - `end` string, date, nullable, required
    - `reconciled` boolean, required
    - `can_issue` boolean, required
    - `form_2` boolean, required
    - `ledger_summary` RpLedgerSummary[], required: External receipts and payments per general ledger account.
      - `account_code` string, required
      - `account_name` string, required
      - `receipts` string, required
      - `payments` string, required
      - `receipts_gst_component` string, required
      - `payments_gst_component` string, required
      - `count` integer, 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)