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": 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

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
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[]
I