Every endpoint that returns an item, and every webhook event, uses this same object. Money values are numbers, not strings. New fields may be added over time, so ignore any you don't recognise.
An item with variations — a T-shirt in three sizes, say — is a variant group plus one item per variation. The variations hold the stock; the group's quantity is their total.
{
"id": 123,
"name": "Blue Mug",
"sku": "MUG-BLU",
"quantity": 14,
"unitCost": 4.5,
"salePrice": 12,
"lowStockThreshold": 5,
"description": "12 oz ceramic mug",
"barcode": "0123456789012",
"folderId": 7,
"folderName": "Kitchen",
"parentItemId": null,
"variantValues": null,
"isVariantGroup": false,
"archived": false,
"createdAt": "2026-10-01T14:03:11.000Z",
"updatedAt": "2026-10-12T09:41:27.000Z",
"url": "https://app.simpleinventory.io/item/123"
}
idinteger
- The item's unique ID.
namestring
- The item's name.
skustring | null
- Your stock-keeping unit.
quantityinteger
- Stock on hand. For a variant group, the total of its variations.
unitCostnumber | null
- What one unit costs you.
salePricenumber | null
- What you sell one unit for.
lowStockThresholdinteger | null
- The stock level that counts as low.
descriptionstring | null
- Free-text description.
barcodestring | null
- Stored barcode value.
folderIdinteger | null
- The folder the item is in.
folderNamestring | null
- That folder's name.
parentItemIdinteger | null
- On a variation: the ID of its variant group.
variantValuesobject | null
- On a variation: which options it is, e.g.
{"Size": "M"}. isVariantGroupboolean
- True for a variant group. It holds no stock of its own.
archivedboolean
- True once the item has been archived.
createdAtstring
- When the item was created (ISO 8601, UTC).
updatedAtstring
- When the item last changed (ISO 8601, UTC).
urlstring
- Link to the item in Simple Inventory.