Get started
Integrations
Use cases
API reference
- Accounting
- Overview
- Accounts
- Async Task
- Batch
- 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 items
curl --request GET \
--url https://api.maesn.dev/accounting/items \
--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": "02c74e8a-b95b-ef11-bfe2-002248e5aac5",
"assetAccountId": "80",
"expenseAccountId": "81",
"incomeAccountId": "79",
"inventoryStartDate": "2021-01-01",
"itemNumber": "12345-A",
"lastModifiedDate": "2021-01-01T00:00:00Z",
"name": "Handmade Plastic Chair",
"priceIncludesTax": true,
"stockCount": 11,
"taxCode": "TAX19",
"taxRatePercentage": 19,
"type": "PRODUCT",
"unitName": "PIECE",
"unitPurchasePrice": 10,
"unitSalesPrice": 20.5
}
]
}
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.
Supported filters:
itemNumber
lastModifiedAt
type
Support pagination: true
Support rawData: true
Supported Response Fields:
Available options: PRODUCT
, SERVICE
Supported filters:
lastModifiedAt
Support pagination: true
Support rawData: true
Supported Response Fields:
Available options: PRODUCT
, SERVICE
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:
itemNumber
lastModifiedAt
type
Support pagination: true
Support rawData: true
Supported Response Fields:
Available options: PRODUCT
, SERVICE
Available options: HOUR
, KILOGRAM
, LITRE
, METRE
, MILLILITRE
, MILLIGRAM
, PACK
, SQUARE_METRE
, TONNE
, UNIT
,
CUBIC_METRE
, DAY
, GRAM
, KILOMETRE
, MONTH
, NIGHT
, NOT_UNIT
, PERCENTAGE
Customized values are supported.
Query Parameters
5
, 10
, 20
, 50
, 100
Response
The response is of type object
.
Was this page helpful?
curl --request GET \
--url https://api.maesn.dev/accounting/items \
--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": "02c74e8a-b95b-ef11-bfe2-002248e5aac5",
"assetAccountId": "80",
"expenseAccountId": "81",
"incomeAccountId": "79",
"inventoryStartDate": "2021-01-01",
"itemNumber": "12345-A",
"lastModifiedDate": "2021-01-01T00:00:00Z",
"name": "Handmade Plastic Chair",
"priceIncludesTax": true,
"stockCount": 11,
"taxCode": "TAX19",
"taxRatePercentage": 19,
"type": "PRODUCT",
"unitName": "PIECE",
"unitPurchasePrice": 10,
"unitSalesPrice": 20.5
}
]
}