Skip to main content
GET
/
accounting
/
items
cURL
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": 125,
      "perPage": 50,
      "currentPage": 1,
      "totalPages": 3
    }
  },
  "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

Supported filters: noneSupport pagination: trueSupport rawData: true
Supported Response Fields:
​
id
string
​
expenseAccountId
string
​
incomeAccountId
string
​
name
string
​
stockCount
number
​
taxCode
string
​
taxRatePercentage
number
​
type
enum
Available options: PRODUCT, SERVICE
​
unitPurchasePrice
number
​
unitSalesPrice
number
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: trueSupport rawData: true
Supported Response Fields:
​
itemNumber
string
​
name
string
​
priceIncludesTax
boolean
​
stockCount
number
​
type
enum
Available options: PRODUCT, SERVICE
​
unitName
string
​
unitPurchasePrice
number
​
unitSalesPrice
number
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
​
lastModifiedDate
string
​
name
string
​
stockCount
number
​
taxCode
string
​
unitName
string
​
unitPurchasePrice
number
​
unitSalesPrice
number
Supported filters:
  • lastModifiedAt
Support pagination: trueSupport rawData: true
Supported Response Fields:
​
id
string
​
assetAccountId
string
​
expenseAccountId
string
​
incomeAccountId
string
​
inventoryStartDate
string
​
lastModifiedDate
string
​
name
string
​
stockCount
number
​
taxCode
string
​
type
enum
Available options: PRODUCT, SERVICE
​
unitPurchasePrice
number
​
unitSalesPrice
number
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: trueSupport rawData: true
Supported Response Fields:
​
itemNumber
string
​
name
string
​
priceIncludesTax
boolean
​
taxRatePercentage
number
​
type
enum
Available options: PRODUCT, SERVICE
​
unitSalesPrice
number
​
unitName
enum
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.

Headers

​
X-API-KEY
string
required

API key

​
X-ACCOUNT-KEY
string
required

Account key

Query Parameters

​
page
number
​
limit
enum<number>
Available options:
5,
10,
20,
50,
100
​
companyId
string
​
environmentName
string
​
itemNumber
string
​
lastModifiedAt
number
​
type
string
​
rawData
boolean

Response

200 - application/json
​
meta
object
​
data
object[]