Get started
Integrations
Use cases
API reference
- Accounting
- Overview
- Accounts
- Async Task
- Bills
- Bill Lines
- Bookings
- Booking Proposals
- Contacts
- Customers
- Dimensions
- Expenses
- Files
- Invoices
- Invoice Lines
- Items
- Journals
- Journal Entries
- Offers
- Offer Lines
- Payments
- Payment Terms
- Projects
- Sales Orders
- Sales Order Lines
- Suppliers
- Tax Rates
- Transactions
- Vendor Credits
- Authentication
- Tenant Management
- User
Get account
curl --request GET \
--url https://api.maesn.dev/accounting/accounts/{accountId} \
--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",
"accountNumber": "0150",
"accountSystem": "Internal",
"balance": 100,
"bankName": "F. van Lanschot Bankiers",
"bic": "SNSBNL2A",
"class": "ASSET",
"code": "91",
"currency": "EUR",
"debitCreditIndicator": "DEBIT",
"description": "Business Savings Account",
"iban": "NL46INGB3591831883",
"importType": "CSV",
"name": "Business Bank",
"parentAccountId": "46",
"status": "ACTIVE",
"type": "BANK",
"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:
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.
Support rawData: false
Supported Response Fields:
Available options:
ASSET
Available options (3-letter ISO 4217):
EUR
Available options:
ACTIVE
, ARCHIVED
Available options:
GIRO
, PAYMENT_PROVIDER
Support rawData: true
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
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:
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
Support rawData: true
Supported Response Fields:
Available options:
CSV
, MT940
,
Available options:
BANK
, CURRENT_ASSET
Available options:
ACTIVE
, ARCHIVED
Support rawData: true
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
Path Parameters
Response
The response is of type object
.
Was this page helpful?
curl --request GET \
--url https://api.maesn.dev/accounting/accounts/{accountId} \
--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",
"accountNumber": "0150",
"accountSystem": "Internal",
"balance": 100,
"bankName": "F. van Lanschot Bankiers",
"bic": "SNSBNL2A",
"class": "ASSET",
"code": "91",
"currency": "EUR",
"debitCreditIndicator": "DEBIT",
"description": "Business Savings Account",
"iban": "NL46INGB3591831883",
"importType": "CSV",
"name": "Business Bank",
"parentAccountId": "46",
"status": "ACTIVE",
"type": "BANK",
"updatedDate": "2021-01-01T00:00:00Z"
}
}