Skip to main content
GET
/
accounting
/
journalEntries
cURL
curl --request GET \
  --url https://api.maesn.dev/accounting/journalEntries \
  --header 'X-ACCOUNT-KEY: <x-account-key>' \
  --header 'X-API-KEY: <x-api-key>'
{
  "meta": {
    "warnings": [
      "Field not used by target system"
    ],
    "pagination": {
      "total": 123,
      "perPage": 123,
      "currentPage": 123,
      "totalPages": 123
    }
  },
  "data": [
    {
      "id": "8df2df10-0fae-40ad-9d22-f25e5ab0ba23",
      "accountId": "94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9",
      "accountingPeriodId": "2021-06",
      "createdDate": "2021-01-01T00:00:00Z",
      "currency": "EUR",
      "description": "Hotel for dreamforce",
      "documentId": "b5e624e5-fb9e-4836-a443-87a3820f5b48",
      "files": [
        "file1.pdf"
      ],
      "journalLineItems": [
        {
          "id": "94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9",
          "accountCode": "4034",
          "accountId": "da33b47c-98ca-4410-9c59-5db485ecaeb0",
          "accountNumber": 8200,
          "createdDate ": "2021-01-01T00:00:00Z",
          "currency": "EUR",
          "customerId": "782d89b56-13ae-47a6-8a2a-45e6ddc50d9",
          "debitCreditIndicator": "DEBIT",
          "description": "Uitgesteld 21600001 Kantoor 01-01-2021-31-12-2021",
          "dimensions": [
            {
              "id": "efa82f42-fd85-11e1-a21f-0800200c9a33",
              "name": "Material/Waren"
            }
          ],
          "documentNumber": "123456789",
          "exchangeRate": 1,
          "supplierId": "998933b56-13ae-47a6-8a32a-45e6ddc50d9",
          "taxRate": {
            "id": "1895b05b-38a6-4a6a-9653-166389894350",
            "code": "03",
            "name": "Tax19",
            "taxRatePercentage": "19"
          },
          "thirdPartyCode": "112233",
          "totalGrossAmount": 1190,
          "totalNetAmount": 1000,
          "totalTaxAmount": 190,
          "updatedDate": "2021-01-01T00:00:00Z"
        }
      ],
      "journalCode": "60",
      "journalType": "FIN",
      "number ": "21900030",
      "transactionDate": "2021-01-01T00:00:00Z",
      "updatedDate": "2021-01-01T00:00:00Z"
    }
  ]
}

Field support per integration

Supported filters: noneSupport pagination: trueSupport rawData: true
Supported Response Fields:
id
string
journalLineItems
JournalLineItem[]
number
string
transactionDate
string
If you’re not using the Interactive Authentication Flow, make sure the query parameters environmentName and companyId are correctly populated. You can obtain these values by using the GET Environments and GET Companies endpoints available under the Authentication section.
Supported filters:
  • lastModifiedAt
Support pagination: trueSupport rawData: true
Supported Response Fields:
id
string
accountId
string
description
string
number
string
updatedDate
string
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: noneSupport pagination: trueSupport rawData: true
Supported Response Fields
currency
string
description
string
documentId
string
journalLineItems
JournalLineItem[]
number
string
transactionDate
string
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:
  • lastModifiedAt
Support pagination: trueSupport rawData: true
Supported Response Fields:
id
string
accountingPeriodId
string
createdDate
string
description
string
journalCode
string
journalType
string
number
string
updatedDate
string
Supported filters:
  • lastModifiedAt
Support pagination: trueSupport rawData: true
Supported Response Fields:
id
string
accountingPeriodId
string
description
string
journalCode
string
journalType
string
number
string
transactionDate
string
If you’re not using the Interactive Authentication Flow, make sure the query parameters environmentName and companyId are correctly populated. You can obtain these values by using the GET Companies endpoint available under the Authentication section. Please use the id field as the companyId and the environmentId field as the environmentName.
Supported filters:
  • lastModifiedAt
Support pagination: trueSupport rawData: true
Supported Response Fields:
id
string
accountingPeriodId
string
createdDate
string
description
string
journalLineItems
JournalLineItem[]
journalType
string
number
string
transactionDate
string
updatedDate
string
Supported filters:
  • lastModifiedAt
Support pagination: trueSupport rawData: true
Supported Response Fields:
id
string
createdDate
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
journalCode
string
journalType
string
number
string
transactionDate
string
updatedDate
string
Supported filters:
  • lastModifiedAt
Support pagination: trueSupport rawData: true
Supported Response Fields:
id
string
accountingPeriodId
string
description
string
description
string
journalLineItems
JournalLineItem[]
number
string
transactionDate
string
updatedDate
string

Headers

X-API-KEY
string
required

API key

Example:

"example value"

X-ACCOUNT-KEY
string
required

Account key

Example:

"example value"

Query Parameters

page
number
limit
enum<number>
Available options:
5,
10,
20,
50,
100
companyId
string
environmentName
string
fiscalYear
number
lastModifiedAt
number
rawData
boolean

Response

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