Skip to main content
GET
/
accounting
/
accounts
cURL
curl --request GET \
  --url https://api.maesn.dev/accounting/accounts \
  --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": "5570042",
      "balance": 100,
      "class": "ASSET",
      "code": "91",
      "createdDate": "2025-05-01T00:00:00Z",
      "currency": "EUR",
      "debitCreditIndicator": "DEBIT",
      "description": "Business Savings Account",
      "name": "Business Bank",
      "number": "0150",
      "parentAccountId": "46",
      "status": "ACTIVE",
      "type": "BANK",
      "updatedDate": "2021-06-01T00:00:00Z"
    },
    {
      "id": "5942390",
      "balance": 5000,
      "class": "REVENUE",
      "code": "92",
      "createdDate": "2021-05-01T00:00:00Z",
      "currency": "EUR",
      "debitCreditIndicator": "CREDIT",
      "description": "Income from business activity",
      "name": "Revenue account",
      "number": "1820",
      "parentAccountId": "47",
      "status": "ACTIVE",
      "type": "REVENUE",
      "updatedDate": "2021-06-01T00:00:00Z"
    }
  ]
}

​
Field support per integration

Supported filters: noneSupport pagination: trueSupport rawData: true
Supported Response Fields:
​
id
string
​
class
enum
Available options: ASSET, EXPENSE, LIABILITY, REVENUE, COMPLETE
​
name
string
​
number
string
​
status
enum
Available options: ACTIVE, ARCHIVED
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
​
balance
number
​
class
enum
Available options:
ASSET, EQUITY, EXPENSE, LIABILITY, REVENUE
Business Central allows custom account classes. If custom values are used and no clear mapping to the provided enums exists, the field will return the original string value.
​
name
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:
​
description
string
​
number
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: noneSupport pagination: falseSupport rawData: false
Supported Response Fields:
​
name
string
​
type
string
Available options: CASH,ACCOUNTS_RECEIVABLE,ACCOUNTS_PAYABLE
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
​
class
string
Available options: ASSET, EQUITY, EXPENSE, LIABILITY, REVENUE
​
code
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
​
type
string
Available options: CASH, BANK, CREDIT_CARD, PAYMENT_PROVIDER, ACCOUNTS_RECEIVABLE, PRE_PAYMENT, ACCOUNTS_PAYABLE, VAT, EMPLOYEES_PAYABLE, PREPAID_EXPENSES, ACCRUED_EXPENSES, INCOME_TAX_PAYABLE, FIXED_ASSET, NON_CURRENT_ASSET, DEPRECIATION, INVENTORY, EQUITY, RETAINED_EARNINGS, LONG_TERM_LIABILITY, CURRENT_LIABILITY, OTHER, TAX_PAYABLE, REVENUE, COST_OF_GOODS_SOLD, OTHER_EXPENSE, OVERHEADS, DEPRECIATION, RESEARCH_AND_DEVELOPMENT, EMPLOYEE_COSTS, EMPLOYMENT_COSTS, EXCEPTIONAL_COSTS, EXCEPTIONAL_INCOME, INCOME_TAXES, INTEREST_INCOME, YEAR_END_REFLECTION, INDIRECT_YEAR_END_COSTING, DIRECT_YEAR_END_COSTING
​
updatedDate
string
Supported filters:
  • lastModifiedAt
Support pagination: trueSupport rawData: true
Supported Response Fields:
​
id
string
​
description
string
​
number
string
​
status
enum
Available options: ACTIVE, ARCHIVED
This endpoint retrieves only the posting categories from Lexware Office, which represent the general ledger (GL) accounts. No financial accounts are returned.
Supported filters: noneSupport pagination: trueSupport rawData: true
Supported Response Fields:
​
id
string
​
name
string
​
type
string
Supported filters:
  • lastModifiedAt
Support pagination: trueSupport rawData: true
Supported Response Fields:
​
id
string
​
balance
number
​
class
string
Available options: ASSET, EQUITY, EXPENSE, LIABILITY, REVENUE
​
code
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
​
name
string
​
parentAccountId
string
​
status
enum
Available options: ACTIVE, ARCHIVED
​
type
string
​
updatedDate
string
Supported filters:
  • lastModifiedAt
Support pagination: trueSupport rawData: true
Supported Response Fields:
​
id
string
​
balance
number
​
class
string
Available options: ASSET, EQUITY, EXPENSE, LIABILITY, REVENUE
​
code
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
​
name
string
​
parentAccountId
string
​
status
enum
Available options: ACTIVE, ARCHIVED
​
type
string
​
updatedDate
string
This endpoint is available only for the following countries: Accounting Plus: 🇨🇦, 🇬🇧, 🇮🇪
Accounting Standard: 🇬🇧, 🇮🇪
Accounting Start: 🇨🇦, 🇬🇧, 🇮🇪
When handling a new connection in your integration, it is advisable to first determine which subscription your customer is using to ensure compatibility. To do this, you can use the GET Companies call to retrieve all businesses available for the user. The user will then select one of these businesses. It is also a good practice to verify that the active property of the selected business is set to true before proceeding with the integration setup.
Supported filters:
  • lastModifiedAt
Support pagination: trueSupport rawData: true
Supported Response Fields:
​
id
string
​
class
string
​
code
string
​
createdDate
string
​
description
string
​
name
string
​
type
string
​
updatedDate
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
​
code
string
​
createdDate
string
​
description
string
​
name
string
​
status
enum
Available options: ACTIVE, ARCHIVED
​
type
string
Available options: CUSTOMER, PROVIDER, BANK, CASH, CHARGE, REVENUE, CAPITAL, FIXED_ASSET, MANAGEMENT_RESULT, DEPRECIATION_PROVISION, STOCK, RESULT_BALANCE_SHEET, EMPLOYEE, TITLE, CURRENT_ASSETS, BORROWED_CAPITAL, COST, REDUCTION_IN_EXPENSES, NEUTRAL_REVENUE, NEUTRAL_EXPENSES, SALES_DEDUCTION, EXCHANGE_RATE_INCOME, EXCHANGE_RATE_EXPENSE, BALANCE_CARRIED_FORWARD, AGGREGATE_CARRIED_FORWARD, OTHER_BALANCE_SHEET_ACCOUNT, STATISTICAL_BALANCE, STATISTICAL_CONSUMPTION, CURRENT_ASSETS_INPUT_TAX, BORROWED_CAPITAL_OUTPUT_TAX, CUSTOMER_PREPAYMENT, SUPPLIER_PREPAYMENT, CUSTOMER_PREPAYMENT_TAX_INCLUDED, SUPPLIER_PREPAYMENT_TAX_INCLUDED, INPUT_TAX, OUTPUT_TAX, SUPPLIER_RETURNABLE_PACKAGING, CUSTOMER_RETURNABLE_PACKAGING
​
updatedDate
string
Supported filters:
  • lastModifiedAt
Support pagination: trueSupport rawData: true
Supported Response Fields:
​
description
string
​
name
string
​
number
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:
  • types: Supported values are PNL, BAS, CRD, DEB, KPL. You can filter for one or more types, for example: ?types=PNL,BAS,CRD.
Support pagination: trueSupport rawData: false
Supported Response Fields:
Note that only Profit and Loss (PNL) and Balance Sheet (BAS) accounts are returned by default. Please use the filter types if you require any of the other account types.
​
id
string
​
code
string
​
name
string
​
type
string
​
updatedDate
string
Supported filters:
  • lastModifiedAt
Support pagination: trueSupport rawData: true
Supported Response Fields:
​
id
string
​
class
enum
Available options:
ASSET, EQUITY, EXPENSE, LIABILITY, REVENUE
​
code
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
​
name
string
​
number
string
​
status
enum
Available options: ACTIVE, ARCHIVED
​
type
string
Available options:
BANK, CURRENT_ASSET, CURRENT_LIABILITY, DEPRECIATION, DIRECT_COSTS, EQUITY, EXPENSE, FIXED_ASSET, INVENTORY, LIABILITY, NON_CURRENT_ASSET, OTHER_INCOME, OVERHEADS, PRE_PAYMENT, REVENUE, SALES, NON_CURRENT_LIABILITY
​
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
​
types
string
​
lastModifiedAt
number
​
rawData
boolean

Response

200 - application/json
​
meta
object
​
data
object[]
Example:
[
  {
    "id": "5570042",
    "balance": 100,
    "class": "ASSET",
    "code": "91",
    "createdDate": "2025-05-01T00:00:00Z",
    "currency": "EUR",
    "debitCreditIndicator": "DEBIT",
    "description": "Business Savings Account",
    "name": "Business Bank",
    "number": "0150",
    "parentAccountId": "46",
    "status": "ACTIVE",
    "type": "BANK",
    "updatedDate": "2021-06-01T00:00:00Z"
  },
  {
    "id": "5942390",
    "balance": 5000,
    "class": "REVENUE",
    "code": "92",
    "createdDate": "2021-05-01T00:00:00Z",
    "currency": "EUR",
    "debitCreditIndicator": "CREDIT",
    "description": "Income from business activity",
    "name": "Revenue account",
    "number": "1820",
    "parentAccountId": "47",
    "status": "ACTIVE",
    "type": "REVENUE",
    "updatedDate": "2021-06-01T00:00:00Z"
  }
]
⌘I