CheckAccountTransaction

Create a new transaction

Changed on Jul 13, 2026

Creates a new transaction on a check account. This should only be used with check account type online, preferably for csv import accounts.

post/CheckAccountTransaction

Request

Base URL
https://my.sevdesk.de/api/v1
Auth
API key in header Authorization

Request body

idinteger

The check account transaction id

objectNamestring

The check account transaction object name

createstring date-time

Date of check account transaction creation

updatestring date-time

Date of last check account transaction update

valueDatestring date-time required

Date the check account transaction was booked

entryDatestring date-time nullable

Date the check account transaction was imported

paymtPurposestring nullable

The purpose of the transaction

amountnumber float required

Amount of the transaction

payeePayerNamestring nullable required

Name of the other party

payeePayerAcctNostring nullable

IBAN or account number of the other party

payeePayerBankCodestring nullable

BIC or bank code of the other party

status100 | 200 | 300 | 400 required

Status of the check account transaction. 100 <-> Created 200 <-> Linked 300 <-> Private 400 <-> Booked

Example request

{
  "valueDate": "2024-05-10T00:00:00+02:00",
  "entryDate": "2024-05-10T00:00:00+02:00",
  "paymtPurpose": "salary",
  "amount": 100.1,
  "payeePayerName": "Cercei Lannister"
}

Response

Created - Returns created transaction

idstring

The check account transaction id

objectNamestring

The check account transaction object name

createstring date-time

Date of check account transaction creation

updatestring date-time

Date of last check account transaction update

valueDatestring date-time

Date the check account transaction was imported

entryDatestring date-time nullable

Date the check account transaction was booked

paymtPurposestring nullable

The purpose of the transaction

amountstring

Amount of the transaction

payeePayerNamestring nullable

Name of the other party

payeePayerAcctNostring nullable

IBAN or account number of the other party

payeePayerBankCodestring nullable

BIC or bank code of the other party

gvCodestring nullable

ZKA business transaction code. This can be given for finAPI accounts.

entryTextstring nullable

Transaction type, according to the bank. This can be given for finAPI accounts.

primaNotaNostring nullable

Transaction primanota. This can be given for finAPI accounts.

status'100' | '200' | '300' | '350' | '400'

Status of the check account transaction. 100 <-> Created 200 <-> Linked 300 <-> Private 350 <-> Auto-booked without user confirmation 400 <-> Booked

enshrinedstring date-time

Timepoint when the transaction was enshrined.

Example response

{
  "id": "1",
  "objectName": "CheckAccountTransaction",
  "sevClient": {
    "id": "0",
    "objectName": "SevClient"
  },
  "valueDate": "2024-05-10T00:00:00+02:00",
  "entryDate": "2024-05-10T00:00:00+02:00",
  "paymtPurpose": "salary",
  "amount": "-100.32",
  "payeePayerName": "Cercei Lannister",
  "checkAccount": {
    "id": "0",
    "objectName": "CheckAccount"
  },
  "sourceTransaction": {
    "id": "0",
    "objectName": "CheckAccountTransaction"
  },
  "targetTransaction": {
    "id": "0"
  }
}

Changes

Jul 13, 2026a32cec0fecea Revision changes
- warning
  added the new 350 enum value to the response property for the response status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
Aug 6, 2024a12897a73d08 Revision changes
- breaking
  the response property became nullable for the status
- breaking
  the response property became nullable for the status
- breaking
  the response property became nullable for the status
- warning
  removed the request property
- info
  the endpoint scheme security api_key was added to the API
- info
  added the new optional request property
- info
  added the new optional request property
- info
  the request property became nullable
- info
  the request property became nullable
- info
  the request property became nullable
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  the response optional property became not read-only for the status
- info
  the response optional property became not read-only for the status
- info
  the response optional property became not read-only for the status
- info
  the response optional property became not read-only for the status
- info
  the response optional property became not read-only for the status

Operation history