# Read an inventory item

Returns one item from the catalogue, with its stock settings, how it may be
obtained, and what happens when it is allocated.
nice carries the worked-out stock position - allocated, distributed, available
and a stock_level percentage - which is the useful view of how much is left,
since quantity on its own is the figure the item was stocked with.

Endpoint: GET /api/v2/inventory/item/{id}
Version: 2.0.0
Security: default

## Path parameters:

  - `id` (integer, required)
    The ID of the inventory item.

## Header parameters:

  - `Rosterfy-Platform` (string)

## Response 200 fields (application/json):

  - `object` (object)

  - `object.id` (integer)

  - `object.parent_id` (string | null)

  - `object.type` (string)

  - `object.external_id` (string)

  - `object.certificate_id` (string | null)

  - `object.is_image` (integer)

  - `object.icon` (string)

  - `object.variation_config` (string | null)

  - `object.has_quantity` (integer)

  - `object.quantity` (integer)

  - `object.max_per_user` (integer)

  - `object.has_serial` (integer)

  - `object.category_id` (string | null)

  - `object.serial_assignment_mode` (string | null)

  - `object.is_distributable` (integer)

  - `object.is_redeemable` (integer)

  - `object.ttl` (string | null)

  - `object.reward_point_cost` (integer)

  - `object.budget_cost` (string)

  - `object.publish` (integer)

  - `object.sort_order` (integer)

  - `object.has_variants` (integer)

  - `object.varied_by_attribute_id` (string | null)

  - `object.variant_source_id` (string | null)

  - `object.is_archived` (integer)

  - `object.is_distributable_at_checkin_checkout` (string | null)

  - `object.deleted_at` (string | null)

  - `object.is_erased` (integer)

  - `object.created_at` (string)

  - `object.updated_at` (string)

  - `object.deleted_by` (string | null)

  - `object.is_inheritable` (integer)

  - `object.name` (string)

  - `nice` (object)

  - `nice.created_at` (string)

  - `nice.created_at__date` (string)

  - `nice.created_at__time` (string)

  - `nice.created_at__offset` (string)

  - `nice.created_at__offset_minutes` (integer)

  - `nice.created_at__dayofweek` (string)

  - `nice.external_id` (string)

  - `nice.has_quantity` (string)

  - `nice.has_variants` (string)

  - `nice.is_distributable_at_checkin_checkout` (string)

  - `nice.name` (string)

  - `nice.publish` (string)

  - `nice.type` (string)

  - `nice.type:value` (string)

  - `nice.type:array` (string)

  - `nice.updated_at` (string)

  - `nice.updated_at__date` (string)

  - `nice.updated_at__time` (string)

  - `nice.updated_at__offset` (string)

  - `nice.updated_at__offset_minutes` (integer)

  - `nice.updated_at__dayofweek` (string)

  - `nice.distributed` (integer)

  - `nice.allocated` (integer)

  - `nice.available` (integer)

  - `nice.stock_level` (string)

  - `nice.manual_serial_required` (boolean)

  - `nice.account_name_path` (string)

  - `nice.is_foreign_account` (boolean)

  - `relations` (object)

  - `permissions` (object)

  - `permissions.read` (boolean)

  - `permissions.update` (boolean)

  - `permissions.delete` (boolean)

  - `permissions.redeem` (boolean)

  - `attributes` (object)