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

# Create Bas

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

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

## Path parameters

- `matter_id` string, uuid, required

## Headers

- `Idempotency-Key` string, required

## Request body

- BasCreate
  - `start` string, date, required
  - `end` string, date, required

## Response `201`

Successful Response

- BasDetail
  - `id` string, uuid, required
  - `start` string, date, required
  - `end` string, date, required
  - `revision` integer, required
  - `version` integer, required
  - `status` 'draft' | 'review' | 'approved' | 'finalised' | 'lodged', required
  - `can_finalise` boolean, required
  - `can_edit` boolean, required
  - `can_withdraw` boolean, required
  - `deadline` BasDeadline, required
    - `due_date` string, date, required
    - `timing` 'overdue' | 'due_soon' | 'upcoming', required
  - `returned` BasReturned, required: The reviewer's latest send-back of a draft, for its preparer.
    - `reason` string, nullable, required
    - `returned_by` string, required
    - `returned_at` string, date-time, required
  - `approved` BasApproved, required: Who approved the BAS for finalisation, directly or by finalising it.
    - `approved_by` string, required
    - `approved_at` string, date-time, required
  - `review_transaction_count` integer, required
  - `rows` BasRow[], required
    - `label` string, required
    - `name` string, required
    - `calculated` string, required
    - `manual` string, required
    - `total` string, required
    - `reported` string, required
    - `source_count` integer, required
    - `editable` boolean, required
  - `issues` BasIssue[], required
    - `code` string, required
    - `message` string, required
    - `transaction_id` string, uuid, nullable, required
    - `label` string, nullable, required
    - `reason` string, nullable, required
  - `notices` BasIssue[], required
    - `code` string, required
    - `message` string, required
    - `transaction_id` string, uuid, nullable, required
    - `label` string, nullable, required
    - `reason` string, nullable, required
  - `representative_start` string, date, nullable, required
  - `representative_end` string, date, nullable, required
  - `entries` BasEntryOutput[], required
    - `id` string, uuid, required
    - `label` 'G1' | 'G2' | 'G3' | 'G10' | 'G11' | '1A' | '1B' | 'W1' | 'W2' | 'W3' | 'W4' | 'F1' | 'F2' | 'F3' | 'F4' | '6B' | '5A' | '5B' | '1C' | '1D' | '1E' | '1F' | '7C' | '7D', required
    - `amount` string, decimal, required
    - `reason` string, required
    - `document_ids` string[], required
    - `transaction_id` string, uuid, nullable, required
    - `approval` BasAdjustmentApprovalOutput, required: A manager's decision on an adjustment; the server sets it, never the client.
      - `status` 'pending' | 'approved' | 'returned', required
      - `requested_by` string, uuid, required
      - `requested_at` string, date-time, required
      - `decided_by` string, uuid, nullable, required
      - `decided_at` string, date-time, nullable, required
      - `note` string, nullable, required
  - `source_hash` string, required
  - `reviewed_source_hash` string, nullable, required
  - `total_payable` string, required
  - `finalised_at` string, date-time, nullable, required
  - `lodgement_reference` string, nullable, required
  - `lodged_on` string, date, nullable, required
  - `can_prepare` boolean, required
  - `can_manage` boolean, required
  - `documents` BasDocumentView[], required
    - `id` string, uuid, required
    - `name` string, 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)