# Retrieve Item

Endpoint: GET /organisations/{orgId}/items/{itemId}
Version: v2_28
Security: ApiKeyAuth

## Path parameters:

  - `itemId` (string, required)

  - `orgId` (string, required)
    The organisation identity

## Response 200 fields (application/json):

  - `itemId` (string, required)
    User defined id for the item.

  - `product` (string, required)
    URI for the product that the item is.

  - `createdAtLocation` (string, required)
    URI for the location where the product was created.

  - `materials` (array)
    List of material URIs that are used within the item.

  - `currentLocation` (string, required)
    URI for the location that the item is at or was last at (perhaps it no longer exists as it entered a manufacturing process).

  - `created` (object, required)
    The Date or Date Range that the item was created on.

  - `created.type` (string, required)
    The type of captured date.
    Enum: "EXACT", "RANGE"

  - `created.on` (string)
    If Type is EXACT then this precise date is used.

  - `created.start` (string)
    If type is RANGE then this is the start date.

  - `created.end` (string)
    If type is RANGE then this is the end date.

  - `initialQuantity` (number, required)
    This quantity contained within this item at the point when it was created.

  - `additionalInitialQuantities` (array, required)
    Additiononal quantities can be specified directly on the item.

  - `additionalInitialQuantities.baseUnit` (string, required)
    The additional quantity base unit of measurement.

  - `additionalInitialQuantities.conversionQuantity` (number, required)
    The additional quantity calculated if the product has a conversion to that base unit.

  - `additionalInitialQuantities.overrideQuantity` (number, required)
    An override quantity provided irrespective of whether or not there is a conversion on the product.

  - `remainingQuantity` (number)
    If an item enters a process then this quantity The remaining quantity, some of the item may have been used in a process.

  - `productVariant` (string)
    The uri of the product variant if applicable to this item.

  - `batchNumbers` (array)
    If the item is associated with a particular batch (or multiple batches) then you can use this field to record the batch numbers.

  - `recordState` (string)
    State of the record.
    Enum: "ACTIVE", "ARCHIVED"

  - `id` (string)
    System assigned or user defined id field.

  - `createdBy` (string)
    User who created the record.

  - `createdTime` (string)
    Date & Time that the record was created.

  - `updatedBy` (string)
    Last updated by user.

  - `updatedTime` (string)
    Date & Time that the record was last updated.


## Response 401 fields

## Response 403 fields

## Response 404 fields

## Response 429 fields

## Response 500 fields