Get Item by ID

GET /items/v1/items/{id}
O auth2

Returns the details of a specific item.

Path parameters

  • id integer(int64) Required

    The unique identifier for the item.

Query parameters

Responses

  • 200 application/json

    Item found

    Hide response attributes Show response attributes object
    • id integer(int64)

      The unique identifier for the item.

    • name string

      The name of the item.

    • docketName string

      The name used in the docket for the item.

      Maximum length is 64.

    • sku string

      A stock keeping unit.

      Minimum length is 1, maximum length is 32.

    • active boolean

      Indicates whether or not the item is archived from the menu.

    • barcode string

      The item barcode.

    • barcodes array[string]

      A list of barcodes associated with the item.

    • accountingGroup object

      The accounting group associated with the item.

      Hide accountingGroup attributes Show accountingGroup attributes object
      • id integer(int64)

        The unique identifier for the accounting group.

      • name string

        The name of the accounting group.

    • statisticGroups array[object]

      List of statistic groups associated with the item.

      Hide statisticGroups attributes Show statisticGroups attributes object
      • category string

        The name of the statistic group category.

      • value string

        The statistic group value.

    • costPrice number

      The cost price of the item.

    • prices array[object]

      List of prices associated with the item.

      Hide prices attributes Show prices attributes object
      • amount number

        The item price.

      • name string

        The name for this item price.

    • sharingType string

      How the item is shared.

      Values are GLOBAL_NO_BL, GLOBAL, LOCAL, or SHARED.

    • priceMode string

      The type of price for the item.

      Values are AMOUNT, PERCENT, POSITIVE_OPEN_PRICE, or NEGATIVE_OPEN_PRICE. Default value is AMOUNT.

    • inventorySource string

      Source of inventory for the item.

      Values are PURCHASED or PRODUCED.

    • disabled boolean

      Whether or not stock management is disabled for the item.

    • contentDimension string

      How the item is measured for stock management.

      Values are DIMENSION_LESS, VOLUME, or MASS.

    • contentUom string

      The unit of measure of the item for stock management.

    • contentValue number

      The measurement value.

    • itemType string

      Type of the item.

      Values are ITEM, SEQUENCE, GROUP, or SUB_ITEM.
  • 404 */*

    Item not found

    Hide response attributes Show response attributes object
GET /items/v1/items/{id} 
curl \
 --request GET 'https://api.trial.lsk.lightspeed.app/items/v1/items/141948669132862?businessLocationId=45454565682155' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200) 
{
  "id": 3012455645,
  "name": "Burger",
  "docketName": "The Burger",
  "sku": "UGG-BB-PUR-06",
  "active": true,
  "barcode": "00000001",
  "barcodes": [
    "10011101100"
  ],
  "accountingGroup": {
    "id": 40570261078058,
    "name": "Alcoholic beverages"
  },
  "statisticGroups": [
    {
      "category": "default",
      "value": "Food"
    }
  ],
  "costPrice": 5.0,
  "prices": [
    {
      "amount": 10.0,
      "name": "Tuesday Special"
    }
  ],
  "sharingType": "SHARED",
  "priceMode": "POSITIVE_OPEN_PRICE",
  "inventorySource": "PURCHASED",
  "disabled": false,
  "contentDimension": "MASS",
  "contentUom": "kg",
  "contentValue": 1,
  "itemType": "ITEM"
}
Response examples (404) 
{
  "status": "404",
  "timestamp": "2025-05-04T09:42:00Z",
  "message": "string",
  "apiSubExceptions": [
    {
      "field": "string",
      "rejectedValue": "string",
      "message": "string"
    }
  ]
}