Get Item by ID

GET /items/v1/items/{id}

OAuth2

Returns the details of a specific item.

Path parameters

id integer(int64) Required

The unique identifier for the item.

Query parameters

businessLocationId integer(int64) Required

The unique identifier for the business location.

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.
  
  Additional properties are allowed.
  
  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
- status string
  
  Value is 404.
- timestamp string(date-time)
- message string
- apiSubExceptions array[object]
  
  Hide apiSubExceptions attributes Show apiSubExceptions attributes object
  
  field string
  
  rejectedValue string
  
  message string

GET /items/v1/items/{id}

curl \
 -X GET https://api.trial.lsk.lightspeed.app/items/v1/items/141948669132862?businessLocationId=45454565682155 \
 -H "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": "2024-05-04T09:42:00+00:00",
  "message": "string",
  "apiSubExceptions": [
    {
      "field": "string",
      "rejectedValue": "string",
      "message": "string"
    }
  ]
}