---
title: "Create Transfer"
method: POST
path: "/v1/matters/{matter_id}/cash-book/transfers"
tags: ["cash-book"]
---

# Create Transfer

`POST /v1/matters/{matter_id}/cash-book/transfers`

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

## Path parameters

- `matter_id` string, uuid, required

## Headers

- `Idempotency-Key` string, required

## Request body

- TransferCommand
  - `source_bank_account_id` string, uuid, required
  - `destination_bank_account_id` string, uuid, required
  - `transaction_date` string, date, required
  - `amount` string, decimal, required
  - `description` string, required
  - `reference` string, nullable
  - `funding_pool` 'free' | 'circulating' | 'non_circulating' | 'restricted'

## Response `201`

Successful Response

- TransactionDetail
  - `kind` 'bank' | 'notional', required
  - `bank_account_id` string, uuid, nullable, required
  - `transfer_id` string, uuid, nullable, required
  - `amount` string, decimal, required
  - `allocations` AllocationView[], required
    - `ledger_account_id` string, uuid, required
    - `amount` string, decimal, required
    - `gst_treatment` union, required
      - 'taxable_sale' | 'gst_free_sale' | 'input_taxed_sale' | 'creditable_purchase' | 'purchase_no_credit' | 'outside_gst'
      - 'gst_included' | 'gst_free' | 'no_gst'
    - `gst_amount` string, decimal, required
    - `reporting_category` string, nullable, required
    - `asset_pool` 'circulating' | 'non_circulating' | 'free' | 'mixed' | 'not_applicable' | 'restricted', nullable, required
    - `disbursement_type` 'recoverable_acquisition' | 'recoverable_recharge' | 'other', nullable, required
    - `purchase_kind` 'capital' | 'non_capital', nullable, required
    - `gst_free_kind` 'export' | 'other', nullable, required
    - `narration` string, nullable, required
    - `payee` string, nullable, required
    - `payee_alias` string, nullable, required
    - `contact_id` string, uuid, nullable, required
    - `tax_code` string, nullable, required
    - `tax_code_name` string, nullable, required
    - `calculation_method` 'standard' | 'no_gst' | 'entered', nullable, required
    - `gst_reason` string, nullable, required
    - `invoice_gst` string, decimal, nullable, required
    - `debtor_invoice_reference` string, nullable, required
    - `debtor_gst_reported` boolean, nullable, required
    - `id` string, uuid, required
  - `description` string, required
  - `recipient_bank` RecipientBankOutput, required
    - `account_name` string, required
    - `bsb` string, required
    - `account_number` string, required
    - `reference` string, required
  - `transaction_date` string, date, required
  - `banked_date` string, date, nullable, required
  - `gst_attribution_date` string, date, nullable, required
  - `reference` string, nullable, required
  - `counterparty` string, nullable, required
  - `contact_id` string, uuid, nullable, required
  - `dishonoured_transaction_id` string, uuid, nullable, required
  - `document_ids` string[], required
  - `version` integer, nullable, required
  - `payment` PaymentView, required
    - `status` 'unpaid' | 'aba_generated' | 'paid', required
    - `export_id` string, uuid, nullable, required
    - `paid_date` string, date, nullable, required
    - `reference` string, nullable, required
    - `document_id` string, uuid, nullable, required
    - `remuneration_drawing_id` string, uuid, nullable, required
  - `id` string, uuid, required
  - `dishonoured` boolean, required
  - `closed_period` ClosedPeriod, required: The completed reconciliation that has to be reopened before a change.
    - `reconciliation_id` string, uuid, required
    - `period_end` string, date, required
    - `bank_account_id` string, uuid, required
    - `bank_name` string, required
  - `source_type` 'manual' | 'statement', required
  - `status` 'needs_review' | 'awaiting_approval' | 'approved' | 'posted' | 'discarded', required
  - `dividend_run_id` string, uuid, nullable, required
  - `documents` SupportingDocument[], required
    - `id` string, uuid, required
    - `name` string, required
    - `added_by` string, uuid, nullable, required
    - `added_by_name` string, nullable, required
    - `added_at` string, date-time, nullable, required
  - `history` HistoryItem[], required
    - `action` string, required
    - `occurred_at` string, date-time, required
    - `reason` string, nullable, required
    - `journal_version` integer, nullable, 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)