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
Create expense
curl --request POST \
--url https://api.maesn.dev/accounting/expenses \
--header 'Content-Type: multipart/form-data' \
--header 'X-ACCOUNT-KEY: <x-account-key>' \
--header 'X-API-KEY: <x-api-key>' \
--form 'files=[
null
]' \
--form 'expense={
"id": "E-12345",
"accountId ": "Payroll",
"accountingPeriodId": "2023-12",
"companyId": "12345",
"currency": "EUR",
"customerId": "12345",
"exchangeRate": "Exchange rate",
"expenseLines": [
{
"id": "I-12345",
"accountId": "12345",
"companyId": "12345",
"currency": "EUR",
"customerId": "12345",
"description": "description",
"documentNumber": "12345",
"exchangeRate": "19",
"itemId": "12345",
"supplierId": "12345",
"taxRate": {
"id": "tax rate id",
"code": "code",
"name": "name",
"taxRatePercentage": "tax rate percentage"
},
"totalGrossAmount": "100",
"totalNetAmount": "100",
"trackingCategories": [
{
"id": "tracking category id",
"name": "name"
}
]
}
],
"journalId": "Journal Id",
"memo": "Memo",
"paymentType": "CASH",
"supplierId": "Supplier Id",
"taxRate": {
"id": "tax rate id",
"code": "code",
"name": "name",
"taxRatePercentage": "tax rate percentage"
},
"type": "EXPENSE",
"totalGrossAmount": "100",
"totalNetAmount": "100",
"totalTaxAmount": "5",
"transactionDate": "2021-01-01T00:00:00Z"
}'{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 123,
"perPage": 123,
"currentPage": 123,
"totalPages": 123
}
},
"data": {
"id": "E-12345",
"accountId ": "Payroll",
"accountingPeriodId": "2023-12",
"companyId": "12345",
"createdDate": "2021-01-01T00:00:00Z",
"currency": "EUR",
"customerId": "12345",
"documentId": "12345",
"exchangeRate": "Exchange rate",
"expenseLines": [
{
"id": "I-12345",
"accountId": "12345",
"companyId": "12345",
"createdDate ": "2021-01-01T00:00:00Z",
"currency": "EUR",
"customerId": "12345",
"description": "description",
"documentNumber": "12345",
"exchangeRate": "19",
"itemId": "12345",
"supplierId": "12345",
"taxRate": {
"id": "tax rate id",
"code": "code",
"name": "name",
"taxRatePercentage": "tax rate percentage"
},
"totalGrossAmount": "100",
"totalNetAmount": "100",
"trackingCategories": [
{
"id": "tracking category id",
"name": "name"
}
],
"updatedDate": "2021-01-01T00:00:00Z"
}
],
"files": [
"file1.pdf"
],
"journalId": "Journal id",
"memo": "Memo",
"paymentType": "CASH",
"supplierId": "12345",
"taskId ": "ADB4457839PXTC2220",
"taxRate": {
"id": "tax rate id",
"code": "code",
"name": "name",
"taxRatePercentage": "tax rate percentage"
},
"type": "EXPENSE",
"totalGrossAmount": "100",
"totalNetAmount": "100",
"totalTaxAmount": "5",
"transactionDate": "2021-01-01T00:00:00Z",
"updatedDate": "2021-01-01T00:00:00Z"
}
}Test Api token:
663222ee
Test Account token:
85b30b51
Field support per integration
Supported Request Parameters:
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:
EXPENSE
This endpoints is asynchronous. To check the status of the request, use the GET asyncTask endpoint.
For more info about asynchronous tasks visit the Asynchronous Task section.
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 Request Parameters:
Available options (3-letter ISO 4217):
EUR
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 Request Parameters:
Supported Request Parameters:
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:
EXPENSE, REFUND
Query Parameters
Body
Array of files to upload
"E-12345"
"Payroll"
"2023-12"
"12345"
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 "EUR"
"12345"
"Exchange rate"
"I-12345"
"12345"
"12345"
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 "EUR"
"12345"
"description"
"12345"
"19"
"12345"
"12345"
"100"
"100"
"Journal Id"
"Memo"
CASH, CHECK, CREDIT_CARD "Supplier Id"
EXPENSE, REFUND "100"
"100"
"5"
"2021-01-01T00:00:00Z"
Response
"E-12345"
"Payroll"
"2023-12"
"12345"
"2021-01-01T00:00:00Z"
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 "EUR"
"12345"
"12345"
"Exchange rate"
"I-12345"
"12345"
"12345"
"2021-01-01T00:00:00Z"
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 "EUR"
"12345"
"description"
"12345"
"19"
"12345"
"12345"
"100"
"100"
"2021-01-01T00:00:00Z"
"Journal id"
"Memo"
CASH, CHECK, CREDIT_CARD "12345"
"ADB4457839PXTC2220"
EXPENSE, REFUND "100"
"100"
"5"
"2021-01-01T00:00:00Z"
"2021-01-01T00:00:00Z"
Was this page helpful?
curl --request POST \
--url https://api.maesn.dev/accounting/expenses \
--header 'Content-Type: multipart/form-data' \
--header 'X-ACCOUNT-KEY: <x-account-key>' \
--header 'X-API-KEY: <x-api-key>' \
--form 'files=[
null
]' \
--form 'expense={
"id": "E-12345",
"accountId ": "Payroll",
"accountingPeriodId": "2023-12",
"companyId": "12345",
"currency": "EUR",
"customerId": "12345",
"exchangeRate": "Exchange rate",
"expenseLines": [
{
"id": "I-12345",
"accountId": "12345",
"companyId": "12345",
"currency": "EUR",
"customerId": "12345",
"description": "description",
"documentNumber": "12345",
"exchangeRate": "19",
"itemId": "12345",
"supplierId": "12345",
"taxRate": {
"id": "tax rate id",
"code": "code",
"name": "name",
"taxRatePercentage": "tax rate percentage"
},
"totalGrossAmount": "100",
"totalNetAmount": "100",
"trackingCategories": [
{
"id": "tracking category id",
"name": "name"
}
]
}
],
"journalId": "Journal Id",
"memo": "Memo",
"paymentType": "CASH",
"supplierId": "Supplier Id",
"taxRate": {
"id": "tax rate id",
"code": "code",
"name": "name",
"taxRatePercentage": "tax rate percentage"
},
"type": "EXPENSE",
"totalGrossAmount": "100",
"totalNetAmount": "100",
"totalTaxAmount": "5",
"transactionDate": "2021-01-01T00:00:00Z"
}'{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 123,
"perPage": 123,
"currentPage": 123,
"totalPages": 123
}
},
"data": {
"id": "E-12345",
"accountId ": "Payroll",
"accountingPeriodId": "2023-12",
"companyId": "12345",
"createdDate": "2021-01-01T00:00:00Z",
"currency": "EUR",
"customerId": "12345",
"documentId": "12345",
"exchangeRate": "Exchange rate",
"expenseLines": [
{
"id": "I-12345",
"accountId": "12345",
"companyId": "12345",
"createdDate ": "2021-01-01T00:00:00Z",
"currency": "EUR",
"customerId": "12345",
"description": "description",
"documentNumber": "12345",
"exchangeRate": "19",
"itemId": "12345",
"supplierId": "12345",
"taxRate": {
"id": "tax rate id",
"code": "code",
"name": "name",
"taxRatePercentage": "tax rate percentage"
},
"totalGrossAmount": "100",
"totalNetAmount": "100",
"trackingCategories": [
{
"id": "tracking category id",
"name": "name"
}
],
"updatedDate": "2021-01-01T00:00:00Z"
}
],
"files": [
"file1.pdf"
],
"journalId": "Journal id",
"memo": "Memo",
"paymentType": "CASH",
"supplierId": "12345",
"taskId ": "ADB4457839PXTC2220",
"taxRate": {
"id": "tax rate id",
"code": "code",
"name": "name",
"taxRatePercentage": "tax rate percentage"
},
"type": "EXPENSE",
"totalGrossAmount": "100",
"totalNetAmount": "100",
"totalTaxAmount": "5",
"transactionDate": "2021-01-01T00:00:00Z",
"updatedDate": "2021-01-01T00:00:00Z"
}
}