# Retrieve Item List

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

## Path parameters:

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

## Query parameters:

  - `currentLocation` (string)
    Find items that have the provided location.

  - `itemId` (string)
    Find item with the given item id.

  - `productIds` (array)
    Find items that have the given product ids.

  - `createdAtLocationIds` (array)
    Find items that where created at the provided locations.

  - `currentLocationIds` (array)
    Find items that are at the current location.

  - `recordState` (string)
    Enum: "ACTIVE", "ARCHIVED"

  - `batchNumbers` (array)
    Find any items that have the provided batch numbers.

  - `size` (integer)
    The number of elements to return in each page. Minimum value must be 1, defaults to 20.

  - `page` (integer)
    The pageNo to return. (Zero-based)

## Response 200 fields (application/json):

  - `content` (array, required)

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

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

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

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

  - `content.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).

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

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

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

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

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

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

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

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

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

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

  - `content.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.

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

  - `content.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.

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

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

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

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

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

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

  - `page` (object, required)

  - `page.size` (integer, required)

  - `page.totalElements` (integer, required)

  - `page.totalPages` (integer, required)


## Response 401 fields

## Response 403 fields

## Response 429 fields

## Response 500 fields