Skip to main content
GET
/
accounting
/
expenses
/
{expenseId}
cURL
curl --request GET \
  --url https://api.maesn.dev/accounting/expenses/{expenseId} \
  --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": "9dea18d2-748e-4bda-9f4c-02b08a9622cd",
      "accountCode ": "200",
      "accountId ": "6527a18d2-748e-4bda-9f4c-02b08a9622cd",
      "accountNumber ": 70000,
      "createdDate": "2025-07-15T00:00:00Z",
      "currency": "EUR",
      "customerId": "8a32de4f-55cc-4962-b000-a2a20662b821",
      "description": "Expense_07/25 for business trip",
      "documentId": "c77fbedb-1ff3-4fed-8716-4d3e3fc85ccf",
      "exchangeRate": "1",
      "expenseLines": [
        {
          "id": "b9dade6b-2b69-42c9-bcd4-841960f6cd9f",
          "accountCode": "200",
          "accountId": "56dec6c2-b14c-43ea-87bb-cc67b0ba2545",
          "accountNumber": 4900,
          "createdDate ": "2025-07-15T00:00:00Z",
          "currency": "EUR",
          "description": "Gasoline for business trip",
          "dimensions": [
            {
              "id": "efa82f42-fd85-11e1-a21f-0800200c9a33",
              "name": "Material/Waren"
            }
          ],
          "documentNumber": "EXP-12345",
          "exchangeRate": 1,
          "itemId": "9fc4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
          "taxRate": {
            "id": "1895b05b-38a6-4a6a-9653-166389894350",
            "code": "03",
            "name": "Tax19",
            "taxRatePercentage": "19"
          },
          "totalGrossAmount": 119,
          "totalNetAmount": 100,
          "updatedDate": "2025-07-15T00:00:00Z"
        }
      ],
      "files": [
        "file1.pdf"
      ],
      "journalCode": "60",
      "ledgerName": "Payroll",
      "note": "Gasoline for business trip",
      "paymentTermId": "d2f3e4b5-6a7b-8c9d-0e1f-2g3h4i5j6k7l",
      "paymentType": "CASH",
      "supplierId": "52c049b9-91b7-4828-b346-e1eeadfa31dd",
      "taskId ": "ADB4457839PXTC2220",
      "type": "EXPENSE",
      "totalGrossAmount": 119,
      "totalNetAmount": 100,
      "totalTaxAmount": 19,
      "transactionDate": "2025-07-15T00:00:00Z",
      "updatedDate": "2025-07-15T00:00:00Z"
    }
  ]
}

Field support per integration

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
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
description
string
documentId
string
The documentId is the ID of the document that is attached to the expense.
exchangeRate
string
expenseLines
JournalLineItem[]
journalCode
string
paymentTermId
string
paymentType
string
Available options: CASH, COLLECTION, CREDIT
supplierId
string
type
string
Available options: EXPENSE
totalGrossAmount
number
totalTaxAmount
number
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.
Supported Response Parameters:
id
string
accountNumber
number
customerId
string
documentId
string
expenseLines
JournalLineItem[]
journalCode
string
Support rawData: true
Supported Response Fields:
id
string
accountCode
string
accountId
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
customerId
string
exchangeRate
string
expenseLines
JournalLineItem[]
note
string
supplierId
enum
type
string
Available options: EXPENSE, REFUND
totalGrossAmount
number
totalNetAmount
number
totalTaxAmount
number
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

expenseId
string
required

Query Parameters

companyId
string
rawData
boolean

Response

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