Get started
Integrations
Use cases
API reference
- Accounting
- Overview
- Accounts
- Async Task
- Contacts
- Customers
- Expenses
- Files
- Invoices
- Invoice Lines
- Items
- Journals
- Offers
- Offer Lines
- Projects
- Sales Orders
- Sales Order Lines
- Suppliers
- Tracking categories
- Transactions
- Authentication
- Tenant Management
- User
Get accounts
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": "1",
"accountNumber": "account number 1",
"accountSystem": "account system 1",
"balance": 100,
"bankName": "bank name 1",
"bic": "XXXXDE00",
"class": "ASSET",
"code": "code 1",
"currency": "EUR",
"description": "Business Savings Account",
"iban": "DE00000000000000000000",
"name": "bank account name",
"parentAccountId": "Parent account id",
"status": "ACTIVE",
"type": "BANK",
"updatedDate": "2021-01-01T00:00:00Z"
},
{
"id": "2",
"accountNumber": "account number 2",
"accountSystem": "account system 2",
"balance": 5000,
"bankName": "bank name 2",
"bic": "XXXXDE00",
"class": "",
"code": "code 2",
"currency": "EUR",
"description": "Income from business activity",
"iban": "DE00000000000000000000",
"name": "revenue account name",
"parentAccountId": "Parent account id",
"status": "ACTIVE",
"type": "REVENUE",
"updatedDate": "2021-01-01T00:00:00Z"
}
]
}Test Api token:
663222ee
Test Account token:
85b30b51
Field support per integration
Please ensure the query parameters environmentName and companyId are accurately populated with the appropriate environment and company ID.
You can obtain these values by using the GET Environments and GET Companies endpoints available under the Authentication section.
Supported Response Fields:
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.
Please note that this endpoint only returns the names of the cash ledgers in DATEV Unternehmen Online.
Please ensure the query parameter companyId is accurately populated with the appropriate company ID.
You can obtain this value by using the GET Companies endpoint available under the Authentication section.
Supported Response Fields:
Supported Response Fields:
Available options:
ASSET, EQUITY, EXPENSE, LIABILITY, REVENUE
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
Available options:
ACTIVE, ARCHIVED
Please ensure the query parameters environmentName and companyId are accurately populated with the appropriate environment and company ID.
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 Response Fields:
Available options:
ACTIVE, ARCHIVED
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
Supported Response Fields:
Available options:
ASSET, EQUITY, EXPENSE, LIABILITY, REVENUE
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
Available options:
ACTIVE, ARCHIVED
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
Response
ASSET, EQUITY, EXPENSE, LIABILITY, REVENUE 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 ACTIVE, ARCHIVED ACCOUNTS_PAYABLE, ACCOUNTS_RECEIVABLE, BANK, CREDIT_CARD, CURRENT_ASSET, CURRENT_LIABILITY, DEPRECIATION, DIRECT_COSTS, COST_OF_GOODS_SOLD, EQUITY, EXPENSE, FIXED_ASSET, INVENTORY, LIABILITY, LONG_TERM_LIABILITY, NON_CURRENT_ASSET, NON_CURRENT_LIABILITY, OTHER_INCOME, OTHER_EXPENSE, OVERHEADS, PAYMENT_PROVIDER, PRE_PAYMENT, REVENUE, SALES, OTHER Was this page helpful?
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": "1",
"accountNumber": "account number 1",
"accountSystem": "account system 1",
"balance": 100,
"bankName": "bank name 1",
"bic": "XXXXDE00",
"class": "ASSET",
"code": "code 1",
"currency": "EUR",
"description": "Business Savings Account",
"iban": "DE00000000000000000000",
"name": "bank account name",
"parentAccountId": "Parent account id",
"status": "ACTIVE",
"type": "BANK",
"updatedDate": "2021-01-01T00:00:00Z"
},
{
"id": "2",
"accountNumber": "account number 2",
"accountSystem": "account system 2",
"balance": 5000,
"bankName": "bank name 2",
"bic": "XXXXDE00",
"class": "",
"code": "code 2",
"currency": "EUR",
"description": "Income from business activity",
"iban": "DE00000000000000000000",
"name": "revenue account name",
"parentAccountId": "Parent account id",
"status": "ACTIVE",
"type": "REVENUE",
"updatedDate": "2021-01-01T00:00:00Z"
}
]
}