---
title: "Create Drawing"
method: POST
path: "/v1/matters/{matter_id}/remuneration/drawings"
tags: ["remuneration"]
---

# Create Drawing

`POST /v1/matters/{matter_id}/remuneration/drawings`

## 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}/remuneration/drawings`
- Auth: HTTP bearer

## Path parameters

- `matter_id` string, uuid, required

## Headers

- `Idempotency-Key` string, required

## Request body

- CreateDrawing
  - `payment` DrawingPaymentTerms: Payment details for the Cash Book transaction generated by a drawing.
    - `allocations` AllocationCommandInput[], nullable
      - `ledger_account_id` string, uuid, required
      - `amount` string, decimal, required
      - `gst_treatment` union
        - '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
      - `reporting_category` string, nullable
      - `asset_pool` 'circulating' | 'non_circulating' | 'free' | 'mixed' | 'not_applicable' | 'restricted', nullable
      - `disbursement_type` 'recoverable_acquisition' | 'recoverable_recharge' | 'other', nullable
      - `purchase_kind` 'capital' | 'non_capital', nullable
      - `gst_free_kind` 'export' | 'other', nullable
      - `narration` string, nullable
      - `payee` string, nullable
      - `payee_alias` string, nullable
      - `contact_id` string, uuid, nullable
      - `tax_code` string, nullable
      - `tax_code_name` string, nullable
      - `calculation_method` 'standard' | 'no_gst' | 'entered', nullable
      - `gst_reason` string, nullable
      - `invoice_gst` string, decimal, nullable
      - `debtor_invoice_reference` string, nullable
      - `debtor_gst_reported` boolean, nullable
    - `bank_account_id` string, uuid, required
    - `document_ids` string[]
    - `ledger_account_id` string, uuid, required
    - `payee` string, required
    - `recipient_bank` RecipientBankInput
      - `account_name` string
      - `bsb` string
      - `account_number` string
      - `reference` string
    - `reference` string, nullable
  - `approval_id` string, uuid, required
  - `expected_approval_version` integer, required
  - `drawing_date` string, date, required
  - `amount` string, decimal, required
  - `gst_amount` string, decimal
  - `bank_account_id` string, uuid, nullable
  - `description` string, nullable
  - `source_period_start` string, date, nullable
  - `source_period_end` string, date, nullable
  - `actual_time_costs` string, decimal, nullable
  - `practitioner_user_id` string, uuid, nullable

## Response `201`

Successful Response

- DrawingResult
  - `drawing` DrawingView, required
    - `cashbook_transaction_id` string, uuid, nullable, required
    - `id` string, uuid, required
    - `approval_id` string, uuid, required
    - `approval_revision_id` string, uuid, required
    - `drawing_date` string, date, required
    - `amount` string, decimal, required
    - `gst_amount` string, decimal, required
    - `description` string, nullable, required
    - `source_period_start` string, date, nullable, required
    - `source_period_end` string, date, nullable, required
    - `actual_time_costs` string, decimal, nullable, required
    - `practitioner_user_id` string, uuid, nullable, required
    - `billed_wip` string, decimal, required
    - `absorbed_wip` string, decimal, required
    - `drawn_without_wip` string, decimal, required
    - `requires_review` boolean, required
    - `reversed_at` string, date-time, nullable, required
    - `reversal_reason` string, nullable, required
    - `created_by` string, uuid, required
    - `created_at` string, date-time, required
  - `replayed` boolean, 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)
