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>",
  "opening_balance": 123,
  "pdf": "<string>",
  "items": [
    {
      "account_type": "customer_account",
      "account": "<string>",
      "description": "<string>",
      "external_transaction_id": "<string>",
      "date": "2023-12-25",
      "amount": 123,
      "fee_amount": 123,
      "tax_amount": 123,
      "currency": "<string>",
      "currency_exchange_rate": 123
    }
  ]
}'
{
  "bank_statement_date": "2023-12-25",
  "bank_account_id": "<string>",
  "id": "<string>",
  "external_bank_statement_id": "<string>",
  "items": [
    {
      "account_type": "customer_account",
      "account": "<string>",
      "description": "<string>",
      "external_transaction_id": "<string>",
      "date": "2023-12-25",
      "amount": 123,
      "fee_amount": 123,
      "tax_amount": 123,
      "currency": "<string>",
      "currency_exchange_rate": 123,
      "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 length: 1
external_bank_statement_id
string
required

External bank statement ID

Minimum 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 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