items resource type

Represents an item in Dynamics 365 Business Central.


For information about enabling APIs for Dynamics NAV see Enabling the APIs for Microsoft Dynamics NAV.


Method Return Type Description
GET item items Gets an item object.
POST item items Creates an item object.
PATCH item items Updates an item object.
DELETE item none Deletes an item object.


Method Return Type Description
GET item defaultDimensions default dimensions Gets the default dimensions of item.
POST item defaultDimensions default dimensions Creates the default dimensions of item.
PATCH item defaultDimensions default dimensions Updates the default dimensions of item.
DELETE item defaultDimensions default dimensions Deletes the default dimensions of item.


Property Type Description
id GUID The unique ID of the item. Non-editable.
number string The item number.
displayName string Specifies a description of the item.
type string The inventory type for the item; Inventory, Service, and Non-Inventory. This is a required property.
blocked boolean Specifies that transactions with the item cannot be posted, for example, because the item is in quarantine. Set to true, if item is blocked.
baseUnitOfMeasureId GUID Specifies the ID of the unit of measure.
baseUnitOfMeasure NAV.UnitOfMeasure Specifies the unit in which the item is held in inventory.
gtin numeric This is the Global Trade Item Number.
itemCategory NAV.ItemCategory Specifies the category that the item belongs to.
inventory decimal Specifies how many units, such as pieces, boxes, or cans, of the item are in inventory. Read-Only.
unitPrice decimal Specifies the price for one unit of the item in the specified currency.
priceIncludesTax boolean Specifies that the unitPrice includes tax. Set to true, if unitPrice includes tax.
unitCost decimal Specifies the cost per unit of the item.
taxGroupId GUID Specifies the ID of the Tax Group for the item.
taxGroupCode numeric A Tax Group represents a group of inventory items or resources that are subject to identical tax terms.
lastModifiedDateTime datetime The last datetime the item was modified. Read-Only.


A Tax Group(taxGroupCode) must exist in the Tax Group table.

JSON representation

Here is a JSON representation of the resource.

      "id": "GUID",
      "number": "string",
      "displayName": "string",
      "type": "string",
      "blocked": "boolean",
      "baseUnitOfMeasureId": "GUID",
      "baseUnitOfMeasure": "NAV.UnitOfMeasure",
      "gtin": "numeric",
      "itemCategory": "NAV.ItemCategory",
      "inventory": "decimal",
      "unitPrice": "decimal",
      "priceIncludesTax": "boolean",
      "unitCost": "decimal",
      "taxGroupId": "GUID",
      "taxGroupCode": "string",
      "lastModifiedDateTime": "datetime"

See also

Working with Dynamics 365 Business Central in Microsoft Graph
Enabling the APIs for Microsoft Dynamics NAV
Endpoints for the APIs
Error Codes
Get Item
Post Item
Patch Item
Delete Item