Skip to main content
POST
/
consumers
/
{consumer_id}
/
accounting
/
bank-transactions
Create bank transactions
curl --request POST \
  --url https://api.chift.eu/consumers/{consumer_id}/accounting/bank-transactions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "bank_statement_date": "2023-12-25",
  "bank_account_id": "<string>",
  "external_bank_statement_id": "<string>",
  "items": [
    {
      "date": "2023-12-25",
      "amount": 123,
      "currency": "<string>",
      "account_type": "customer_account",
      "account": "<string>",
      "description": "<string>",
      "external_transaction_id": "<string>",
      "fee_amount": 0,
      "tax_amount": 0,
      "currency_exchange_rate": 1
    }
  ],
  "opening_balance": 123,
  "pdf": "<string>"
}
'
{
  "bank_statement_date": "2023-12-25",
  "bank_account_id": "<string>",
  "items": [
    {
      "date": "2023-12-25",
      "amount": 123,
      "currency": "<string>",
      "account_type": "customer_account",
      "account": "<string>",
      "description": "<string>",
      "external_transaction_id": "<string>",
      "fee_amount": 0,
      "tax_amount": 0,
      "currency_exchange_rate": 1,
      "id": "<string>"
    }
  ],
  "id": "<string>",
  "external_bank_statement_id": "<string>"
}

Authorizations

​
Authorization
string
header
required

This access token needs to be included in each of your request to the Chift API.

Path Parameters

​
consumer_id
string<uuid>
required

Query Parameters

​
folder_id
string | null

Id of the accounting folder instance. A folder represents a legal entity within the system. Required when the multiple folders feature is enabled.

Body

application/json
​
bank_statement_date
string<date>
required

Date of the bank statement

​
bank_account_id
string
required

Unique ID of the bank account in the accounting system

Minimum string length: 1
​
external_bank_statement_id
string
required

External bank statement ID

Minimum string length: 1
​
items
BankTransactionItemIn · object[]
required

List of transaction items

​
opening_balance
number | null

Opening balance of the bank account before the statement

​
pdf
string | null

Base64 PDF attachment of the bank statement.

Response

Successful Response

​
bank_statement_date
string<date>
required

Date of the bank statement

​
bank_account_id
string
required

Unique ID of the bank account in the accounting system

Minimum string length: 1
​
items
BankTransactionItemOut · object[]
required

List of transaction items with their IDs

​
id
string | null

Internal bank statement ID generated by the accounting system

​
external_bank_statement_id
string | null

External bank statement ID