Skip to main content
GET
/
accounting
/
journalEntries
/
{journalEntryId}
cURL
curl --request GET \
  --url https://api.maesn.dev/accounting/journalEntries/{journalEntryId} \
  --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": "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"
      ],
      "isProvisional": "false",
      "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",
              "categoryName": "CostCenter",
              "code": "KD1",
              "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

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.
Support rawData: true
Supported Response Fields:
​
id
string
​
accountId
string
​
description
string
​
files
string[]
​
journalLineItems
JournalLineItem[]
​
number
string
​
updatedDate
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.
Support rawData: true
Supported Response Fields:
​
id
string
​
accountingPeriodId
string
​
createdDate
string
​
description
string
​
journalCode
string
​
journalType
string
​
journalLineItems
JournalLineItem[]
​
number
string
​
updatedDate
string
When retrieving a journal entry by ID, make sure to send the journal code as the journalCode query parameter.
Support rawData: true
Supported Response Fields:
​
id
string
​
accountingPeriodId
string
​
description
string
​
journalCode
string
​
journalLineItems
JournalLineItem[]
​
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.
Support rawData: true
Supported Response Fields:
​
id
string
​
accountingPeriodId
string
​
createdDate
string
​
description
string
​
journalLineItems
JournalLineItem[]
​
journalType
string
​
number
string
​
transactionDate
string
​
updatedDate
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.
Make sure the query parameter journalCode is correctly populated. In order to get the journalCode you can use the GET Journals endpoint available under the Accounting section.
Support rawData: true
Supported Response Fields:
​
id
string
​
createdDate
string
​
currency
string
​
documentId
string
​
isProvisional
boolean
​
journalLineItems
JournalLineItem[]
Support 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
​
journalLineItems
JournalLineItem[]
​
journalType
string
​
number
string
​
transactionDate
string
​
updatedDate
string
Support rawData: true
Supported Response Fields:
​
id
string
​
accountingPeriodId
string
​
createdDate
string
​
description
string
​
files
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"

Path Parameters

​
journalEntryId
string
required

Query Parameters

​
companyId
string
​
environmentName
string
​
journalCode
string
​
rawData
boolean

Response

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