{"title":"items resource type (v1.0)","url":"https://jonas-paprotka.de/docs/dev-itpro/api-reference/v1.0/resources/dynamics_item/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/api-reference/v1.0/resources/dynamics_item, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/api-reference/v1.0/resources/dynamics_item","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"(v1.0) An item object in Dynamics 365 Business Central.","date":"2024-05-01","meta":{"topic":"reference"},"outline":[{"level":1,"title":"items resource type (v1.0)","slug":"items-resource-type-v10","at":0,"chars":3193},{"level":2,"title":"Methods","slug":"methods","at":352,"chars":290},{"level":2,"title":"Navigation","slug":"navigation","at":642,"chars":260},{"level":2,"title":"Properties","slug":"properties","at":902,"chars":1427},{"level":2,"title":"Relationships","slug":"relationships","at":2329,"chars":78},{"level":2,"title":"JSON representation","slug":"json-representation","at":2407,"chars":594},{"level":2,"title":"Related information","slug":"related-information","at":3001,"chars":192}],"text":"# items resource type (v1.0)\n> NEW VERSION This is v1.0 of the Business Central API. For the newest version, see Business Central API (V2.0)<../../v2.0>.\nRepresents an item in Business Central.\n> NOTE\n> For information about enabling APIs for Business Central see Enabling the APIs for Dynamics 365 Business Central<../enabling-apis-for-dynamics-nav>.\n## Methods\nMethod|Return Type|Description\n../api/dynamics_item_get|items|Gets an item object.\nPOST item<../api/dynamics_create_item>|items|Creates an item object.\nPATCH item<../api/dynamics_item_update>|items|Updates an item object.\n../api/dynamics_item_delete|none|Deletes an item object.\n## Navigation\nNavigation|Return Type|Description\ndynamics_picture|picture|Gets the picture of item.\ndynamics_defaultdimension|defaultDimension|Gets the defaultDimension of item.\nItemCategory<dynamics_itemcategories>|itemCategory|Gets the item catgory of item.\n## Properties\nProperty|Type|Description\nid|GUID|The unique ID of the item. Non-editable.\nnumber|string|The item number.\ndisplayName|string|Specifies a description of the item.\ntype|string|The inventory type for the item; Inventory, Service, and Non-Inventory. This is a required property.\nblocked|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.\nbaseUnitOfMeasureId|GUID|Specifies the ID of the unit of measure.\nbaseUnitOfMeasure|NAV.UnitOfMeasure<dynamics_complextypes>|Specifies the unit in which the item is held in inventory.\ngtin|numeric|This is the Global Trade Item Number.\nitemCategory|NAV.ItemCategory<dynamics_complextypes>|Specifies the category that the item belongs to.\ninventory|decimal|Specifies how many units, such as pieces, boxes, or cans, of the item are in inventory. Read-Only.\nunitPrice|decimal|Specifies the price for one unit of the item in the specified currency.\npriceIncludesTax|boolean|Specifies that the unitPrice includes tax. Set to true, if unitPrice includes tax.\nunitCost|decimal|Specifies the cost per unit of the item.\ntaxGroupId|GUID|Specifies the ID of the Tax Group for the item.\ntaxGroupCode|numeric|A Tax Group represents a group of inventory items or resources that are subject to identical tax terms.\nlastModifiedDateTime|datetime|The last datetime the item was modified. Read-Only.\n## Relationships\nA Tax Group(taxGroupCode) must exist in the Tax Group table.\n## JSON representation\nHere is a JSON representation of the resource.\n```json\n{\n      \"id\": \"GUID\",\n      \"number\": \"string\",\n      \"displayName\": \"string\",\n      \"type\": \"string\",\n      \"blocked\": \"boolean\",\n      \"baseUnitOfMeasureId\": \"GUID\",\n      \"baseUnitOfMeasure\": \"NAV.UnitOfMeasure\",\n      \"gtin\": \"numeric\",\n      \"itemCategory\": \"NAV.ItemCategory\",\n      \"inventory\": \"decimal\",\n      \"unitPrice\": \"decimal\",\n      \"priceIncludesTax\": \"boolean\",\n      \"unitCost\": \"decimal\",\n      \"taxGroupId\": \"GUID\",\n      \"taxGroupCode\": \"string\",\n      \"lastModifiedDateTime\": \"datetime\"\n}\n```\n## Related information\n../dynamics_error_codes\ndynamics_item\n../api/dynamics_item_get\nPost Item<../api/dynamics_create_item>\nPatch Item<../api/dynamics_item_update>\n../api/dynamics_item_delete"}