Skip to main content
GET
/
accounting
/
expenses
cURL
curl --request GET \
  --url https://api.maesn.dev/accounting/expenses \
  --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.
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
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
Supported filters:
  • lastModifiedAt
Support pagination: trueSupport rawData: true
Supported Response Fields:
id
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
expenseLines
JournalLineItem[]
paymentType
string
Available options: CASH, CREDIT_CARD, CHECK
totalNetAmount
number
updatedDate
string
Supported filters:
  • lastModifiedAt
Support pagination: trueSupport 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"

Query Parameters

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

Response

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