Retrieve an item

Read one catalogue item by your externalId.

GET{BASE_URL}/catalog/items/{externalId}

Returns one item. Requires the INVENTORY scope.

Path parameters

externalIdstringrequired
Your ID for the item, URL-encoded as a path segment.

Response

dataobjectrequired
The catalogue item.

Status codes#

StatusCodeMeaning
200—Success.
400—externalId is not a valid ID.
404open_network_item_not_foundYou have no item with that externalId.
cURL
curl "$LOCALOY_BASE_URL/catalog/items/sku-4471" \
  -H "Authorization: Bearer $LOCALOY_API_KEY"
Response · 404
{
  "success": false,
  "message": "No catalog item with externalId \"sku-9\"",
  "code": "open_network_item_not_found",
  "requestId": "3f0c9f8e-6a1d-4f5e-9b1a-2f1c0d9e7a41"
}