Skip to main content
GET
/
accounting
/
openItems
cURL
curl --request GET \
  --url https://api.maesn.dev/accounting/openItems \
  --header 'X-ACCOUNT-KEY: <x-account-key>' \
  --header 'X-API-KEY: <x-api-key>'
{
  "meta": {
    "warnings": [
      "Field not used by target system"
    ],
    "pagination": {
      "total": 125,
      "perPage": 50,
      "currentPage": 1,
      "totalPages": 3
    }
  },
  "data": [
    {
      "id": "8df2df10-0fae-40ad-9d22-f25e5ab0ba23",
      "accountId": "10fae-40ad-9d2df2df10-9d22-f44f5ab3eu",
      "accountName": "Vendor ABC",
      "accountNumber": "100100000",
      "createdDate": "2025-06-01T00:00:00Z",
      "currency": "EUR",
      "documentNumber": "INV-1",
      "entries": [
        {
          "amount": 1000,
          "currency": "EUR",
          "debitCreditIndicator": "DEBIT",
          "description": "Hotel stay",
          "dueDate": "2025-06-21T00:00:00Z",
          "postingDate": "2025-06-01T00:00:00Z"
        }
      ],
      "openBalance": {
        "amount": 1000,
        "debitCreditIndicator": "DEBIT"
      },
      "postingDate": "2025-06-01T00:00:00Z",
      "totalCreditAmount": 0,
      "totalDebitAmount": 1000,
      "type": "BILL",
      "updatedDate": "2025-06-12T00:00:00Z"
    }
  ]
}

​
Field support per integration

This endpoint is currently available only during the pilot phase of DATEV Rechnungswesen. For details, see the Pilot phase section
The query parameter fiscalYear is required and must be a valid year.
If you’re not using the Interactive Authentication Flow, make sure the query parameter companyId is correctly populated.
Supported filters:
  • accountNumber
  • documentNumber
Support pagination: trueSupport rawData: true
Supported Response Fields:
​
accountNumber
string
​
documentNumber
string
​
entries
Entry[]
The list of posting entries associated with the document number and account number.
​
openBalance
Balance
​
postingDate
string
​
totalCreditAmount
number
​
totalDebitAmount
number
If you’re not using the Interactive Authentication Flow, make sure the query parameter companyId is correctly populated. You can obtain this value by using the GET Companies endpoint available under the Authentication section.
Supported filters:
  • type
Support pagination: trueSupport rawData: true
Supported Response Fields:
​
id
string
​
accountId
string
​
accountName
string
​
currency
enum
Available options (3-letter ISO 4217): AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYR, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CUC, CVE, CZK, DJF, DKK, DOP, DZD, EEK, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GQE, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LTL, LVL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRO, MUR, MVR, MWK, MXN, MYR, MZM, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, SYP, SZL, THB, TJS, TMT, TND, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VEB, VND, VUV, WST, XAF, XCD, XDR, XOF, XPF, YER, ZAR, ZMK, ZWR
​
documentNumber
string
​
openBalance
Balance
​
postingDate
string
​
totalCreditAmount
number
​
totalDebitAmount
number
​
type
enum
Available options: BILL, INVOICE

Headers

​
X-API-KEY
string
required

API key

​
X-ACCOUNT-KEY
string
required

Account key

Query Parameters

​
page
number
​
limit
enum<number>
Available options:
5,
10,
20,
50,
100
​
companyId
string
​
environmentName
string
​
fiscalYear
number
​
accountNumber
string
​
documentNumber
string
​
type
enum<string>
Available options:
BILL,
INVOICE
​
lastModifiedAt
number
​
rawData
boolean

Response

200 - application/json
​
meta
object
​
data
object[]