---
title: "Create a bank statement"
method: POST
path: "/accounting/bankStatements"
tags: ["Bank Statements"]
---

# Create a bank statement

`POST /accounting/bankStatements`

## Request

- Base URL: `https://api.clearbooks.co.uk/v1`
- URL: `https://api.clearbooks.co.uk/v1/accounting/bankStatements`
- Auth: OAuth 2 (authorization code, authorization URL `https://secure.clearbooks.co.uk/account/action/oauth/`, token URL `https://api.clearbooks.co.uk/oauth/token`, scopes: `accounting.bank_statements:write`)

### Statement consolidation

Clear Books will consolidate statements posted using this API call into monthly statements ready to be explained.
One statement in Clear Books will be maintained for each calendar month based on the transaction date.

The IDs returned by this call represent the statement that the posted transactions were added to, regardless of whether a new
statement was created or the transactions were appended to an existing statement.

### Deduplication

Clear Books will ignore transactions with a `transactionId` that has already been used for the same bank feed. No attempt is
made to deduplicate transactions based on any other properties. Please ensure that each individual transaction you send has
a consistent, unique ID.

## Headers

- `X-Business-ID` integer

## Request body

- object
  - `items` BankStatement[]
    - `id` integer
    - `accountId` integer
    - `feedId` string, required
    - `statementLines` BankStatementLine[]
      - `id` integer
      - `transactionId` string
      - `accountingDate` string, date
      - `description` string, required
      - `amount` number, float, required: A signed floating point number representing the value of the transaction

## Response `201`

Statement created

- object
  - `items` BankStatementSummary[]
    - `id` integer
    - `accountId` integer
    - `feedId` string, required

## Other responses

- `400`: The request was malformed or missing required parameters
- `401`: A valid authorisation token is required to perform this action
- `403`: No permission was granted to perform this action
- `422`: The request was well formed, but could not be actioned due to business rule constraints
- `429`: The application is making too many requests and has been rate limited

---

[API](https://skmtc.dev/clearbooks/apis/clear-books-api.md) · [All operations](https://skmtc.dev/clearbooks/apis/clear-books-api/llms.txt) · [OpenAPI document](https://skmtc.dev/clearbooks/apis/clear-books-api/revisions/5e46fa6863a7?raw)