Jump to

• Request
• Response

v2.0

get

/ec-ors-svc/rest/v2.0/studies/{studyId}/{mode}/inventory/qualified-kits

Retrieves list of kits which had qualified recent updates based on criteria defined by Oracle Clinical One Integration Hub. In this API, blockNumber and kitNumberUTF added to return block number and kit number in UTF-8. Rights: OrsInventoryGet and OrsUnblinded.

Request

Path Parameters

• mode(required): string
  Indicates the operational mode of the study. Accepted values: active, test, or training.
• studyId(required): string(uuid)
  Unique identifier of the study. Uses UUID in a 32-character uppercase hexadecimal string format.

Query Parameters

• endDate(required): string
  End date/time for retrieving qualified kit updates

  Example:

  2026-02-29T23:59:59.999Z

• startDate(required): string
  Start date/time for retrieving qualified kit updates

  Example:

  2026-02-01T00:00:00.000Z

There's no request body for this operation.

Back to Top

Response

Supported Media Types

• application/json

200 Response

Successful operation

Body ()

Root Schema : schema

Type: array

Show Source

• Array of: object Kit Details Extended
  Title: Kit Details Extended

  Kit details with extended fields used by Integration Hub.

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/KitDetailsExtTO"
    }
}

Nested Schema : Kit Details Extended

Type: object

Title: Kit Details Extended

Kit details with extended fields used by Integration Hub.

Show Source

• blindedLotExpirationDate: string (date-time)
  Blinded lot expiration date.
• blindedLotId: string
  Title: Blinded Lot ID

  Blinded lot ID.

  Example: 9BD49A59E47E4383B98802712763FD43
• blindedLotNumber: string
  Title: Blinded Lot Number

  Blinded lot number.

  Example: BLot1101
• blockNumber: string
  Block number.

  Example: 1101
• inventoryId: string (uuid)
  Title: Inventory ID

  Inventory ID.
• inventoryStatus: string
  Title: Inventory Status

  Name of the inventory status.

  Example: Dispensed
• inventoryStatusId: number (BigDecimal)
  Title: Inventory Status ID

  Unique ID corresponding to each inventory status value (1 for Available, 2 for Damaged, 3 for Destroyed, 4 for Dispensed, 5 for Expired, 6 for Not in Use, 7 for Misallocated, 8 for Missing, 9 for In Transit, 10 for Quarantined, 11 for Pre-quarantined, 12 for Pending Destruction, 13 for Lost by Subject, 14 for Temporarily Unavailable, 15 for Damaged by Subject, 16 for New, 17 for Not Dispensed to Subject, 18 for Returned to Site, 19 for Conserved, 20 for Received for Destruction).

  Example: 10
• kitNumber: number (BigDecimal)
  Title: Kit Number

  Kit number.

  Example: 10
• kitNumberUTF: string
  Kit number with UTF-8 support.

  Example: KN1101
• labelGroup: string
  Title: Label Group

  Label group.

  Example: Labelgroup1001
• labelGroupId: string
  Title: Label Group ID

  Label group ID.

  Example: 9BD49A59E47E4383B98802712763FD43
• locationChangeList: array locationChangeList
  List of objects containing location information.
• locationId: string
  Title: Location ID

  Location.

  Example: 1873CDF69E9B48B89B2D9E7951057D09
• manufacturingLotExpirationDate: string (date-time)
  Manufacturing lot expiration date.
• manufacturingLotId: string
  Title: Manufacturing Lot ID

  Manufacturing lot ID.

  Example: 9BD49A59E47E4383B98802712763FD43
• manufacturingLotNumber: string
  Title: Manufacturing Lot Number

  Manufacturing lot number.

  Example: Mlot1001
• prevBlindedLotNumber: string
  Previous blinded lot number.

  Example: BLot1101
• prevInventoryStatus: string
  Previous inventory status.

  Example: Dispensed
• prevInventoryStatusId: number (BigDecimal)
  Previous inventory status ID.

  Example: 10
• prevManufacturingLotNumber: string
  Previous manufacturing lot number.

  Example: Mlot1001
• sequenceNumber: number (BigDecimal)
  Title: Sequence Number

  Sequence number.

  Example: 10

{
    "title":"Kit Details Extended",
    "type":"object",
    "properties":{
        "kitNumber":{
            "title":"Kit Number",
            "type":"number",
            "description":"Kit number.",
            "format":"BigDecimal",
            "example":10
        },
        "sequenceNumber":{
            "title":"Sequence Number",
            "type":"number",
            "description":"Sequence number.",
            "format":"BigDecimal",
            "example":10
        },
        "inventoryStatusId":{
            "title":"Inventory Status ID",
            "type":"number",
            "description":"Unique ID corresponding to each inventory status value (1 for Available, 2 for Damaged, 3 for Destroyed, 4 for Dispensed, 5 for Expired, 6 for Not in Use, 7 for Misallocated, 8 for Missing, 9 for In Transit, 10 for Quarantined, 11 for Pre-quarantined, 12 for Pending Destruction, 13 for Lost by Subject, 14 for Temporarily Unavailable, 15 for Damaged by Subject, 16 for New, 17 for Not Dispensed to Subject, 18 for Returned to Site, 19 for Conserved, 20 for Received for Destruction).",
            "format":"BigDecimal",
            "example":10
        },
        "locationId":{
            "title":"Location ID",
            "type":"string",
            "description":"Location.",
            "example":"1873CDF69E9B48B89B2D9E7951057D09"
        },
        "manufacturingLotId":{
            "title":"Manufacturing Lot ID",
            "type":"string",
            "description":"Manufacturing lot ID.",
            "example":"9BD49A59E47E4383B98802712763FD43"
        },
        "blindedLotId":{
            "title":"Blinded Lot ID",
            "type":"string",
            "description":"Blinded lot ID.",
            "example":"9BD49A59E47E4383B98802712763FD43"
        },
        "labelGroupId":{
            "title":"Label Group ID",
            "type":"string",
            "description":"Label group ID.",
            "example":"9BD49A59E47E4383B98802712763FD43"
        },
        "inventoryStatus":{
            "title":"Inventory Status",
            "type":"string",
            "description":"Name of the inventory status.",
            "example":"Dispensed"
        },
        "manufacturingLotNumber":{
            "title":"Manufacturing Lot Number",
            "type":"string",
            "description":"Manufacturing lot number.",
            "example":"Mlot1001"
        },
        "blindedLotNumber":{
            "title":"Blinded Lot Number",
            "type":"string",
            "description":"Blinded lot number.",
            "example":"BLot1101"
        },
        "labelGroup":{
            "title":"Label Group",
            "type":"string",
            "description":"Label group.",
            "example":"Labelgroup1001"
        },
        "manufacturingLotExpirationDate":{
            "type":"string",
            "description":"Manufacturing lot expiration date.",
            "format":"date-time"
        },
        "blindedLotExpirationDate":{
            "type":"string",
            "description":"Blinded lot expiration date.",
            "format":"date-time"
        },
        "prevInventoryStatusId":{
            "type":"number",
            "description":"Previous inventory status ID.",
            "format":"BigDecimal",
            "example":10
        },
        "prevInventoryStatus":{
            "type":"string",
            "description":"Previous inventory status.",
            "example":"Dispensed"
        },
        "locationChangeList":{
            "type":"array",
            "description":"List of objects containing location information.",
            "items":{
                "$ref":"#/components/schemas/LocationUpdateTO"
            }
        },
        "prevManufacturingLotNumber":{
            "type":"string",
            "description":"Previous manufacturing lot number.",
            "example":"Mlot1001"
        },
        "prevBlindedLotNumber":{
            "type":"string",
            "description":"Previous blinded lot number.",
            "example":"BLot1101"
        },
        "blockNumber":{
            "type":"string",
            "description":"Block number.",
            "example":"1101"
        },
        "kitNumberUTF":{
            "type":"string",
            "description":"Kit number with UTF-8 support.",
            "example":"KN1101"
        },
        "inventoryId":{
            "title":"Inventory ID",
            "type":"string",
            "description":"Inventory ID.",
            "format":"uuid"
        }
    },
    "description":"Kit details with extended fields used by Integration Hub."
}

Nested Schema : locationChangeList

Type: array

List of objects containing location information.

Show Source

• Array of: object LocationUpdateTO v1.0
  Title: LocationUpdateTO v1.0

  Contains location (site/depot) info.

{
    "type":"array",
    "description":"List of objects containing location information.",
    "items":{
        "$ref":"#/components/schemas/LocationUpdateTO"
    }
}

Nested Schema : LocationUpdateTO v1.0

Type: object

Title: LocationUpdateTO v1.0

Contains location (site/depot) info.

Show Source

• locationChangeDate: string (date-time)
  Title: Location Change Date

  Date when inventory site/depot changed.
• locationId: string
  Title: Location ID

  Location ID.

  Example: 1873CDF69E9B48B89B2D9E7951057D09

{
    "title":"LocationUpdateTO v1.0",
    "type":"object",
    "properties":{
        "locationId":{
            "title":"Location ID",
            "type":"string",
            "description":"Location ID.",
            "example":"1873CDF69E9B48B89B2D9E7951057D09"
        },
        "locationChangeDate":{
            "title":"Location Change Date",
            "type":"string",
            "description":"Date when inventory site/depot changed.",
            "format":"date-time"
        }
    },
    "description":"Contains location (site/depot) info."
}

Examples

Select an example Get Qualified Kits Response

400 Response

Invalid date range

Body ()

Root Schema : ORSResponse

Type: object

Common response object.

Show Source

• errorData: object ErrorResponseData
  Title: ErrorResponseData

  Error Response Details Information
• result: object result
  Result Object
• status: string
  Status of request

  Example: Success
• version: integer (int32)

{
    "type":"object",
    "properties":{
        "status":{
            "type":"string",
            "description":"Status of request",
            "example":"Success"
        },
        "result":{
            "type":"object",
            "description":"Result Object"
        },
        "errorData":{
            "$ref":"#/components/schemas/ErrorResponseData"
        },
        "version":{
            "type":"integer",
            "format":"int32"
        }
    },
    "description":"Common response object."
}

Nested Schema : ErrorResponseData

Type: object

Title: ErrorResponseData

Error Response Details Information

Show Source

• details: object Object
  Title: Object

  Object with error details information.
• errorCode: string
  Error code which is stored in ErrorCode enum. Example : C1-003

  Example: C1-003
• errorMessage: string
  Error message which is stored in service property file. Example : Cannot modify object after a study version has been approved

  Example: Cannot modify object after a study version has been approved

{
    "title":"ErrorResponseData",
    "type":"object",
    "properties":{
        "errorCode":{
            "type":"string",
            "description":"Error code which is stored in ErrorCode enum. Example : C1-003",
            "example":"C1-003"
        },
        "errorMessage":{
            "type":"string",
            "description":"Error message which is stored in service property file. Example : Cannot modify object after a study version has been approved",
            "example":"Cannot modify object after a study version has been approved"
        },
        "details":{
            "title":"Object",
            "type":"object",
            "description":"Object with error details information."
        }
    },
    "description":"Error Response Details Information"
}

Nested Schema : result

Type: object

Result Object

Nested Schema : Object

Type: object

Title: Object

Object with error details information.

404 Response

Invalid study ID

Body ()

Root Schema : ORSResponse

Type: object

Common response object.

Show Source

• errorData: object ErrorResponseData
  Title: ErrorResponseData

  Error Response Details Information
• result: object result
  Result Object
• status: string
  Status of request

  Example: Success
• version: integer (int32)

{
    "type":"object",
    "properties":{
        "status":{
            "type":"string",
            "description":"Status of request",
            "example":"Success"
        },
        "result":{
            "type":"object",
            "description":"Result Object"
        },
        "errorData":{
            "$ref":"#/components/schemas/ErrorResponseData"
        },
        "version":{
            "type":"integer",
            "format":"int32"
        }
    },
    "description":"Common response object."
}

Nested Schema : ErrorResponseData

Type: object

Title: ErrorResponseData

Error Response Details Information

Show Source

• details: object Object
  Title: Object

  Object with error details information.
• errorCode: string
  Error code which is stored in ErrorCode enum. Example : C1-003

  Example: C1-003
• errorMessage: string
  Error message which is stored in service property file. Example : Cannot modify object after a study version has been approved

  Example: Cannot modify object after a study version has been approved

{
    "title":"ErrorResponseData",
    "type":"object",
    "properties":{
        "errorCode":{
            "type":"string",
            "description":"Error code which is stored in ErrorCode enum. Example : C1-003",
            "example":"C1-003"
        },
        "errorMessage":{
            "type":"string",
            "description":"Error message which is stored in service property file. Example : Cannot modify object after a study version has been approved",
            "example":"Cannot modify object after a study version has been approved"
        },
        "details":{
            "title":"Object",
            "type":"object",
            "description":"Object with error details information."
        }
    },
    "description":"Error Response Details Information"
}

Nested Schema : result

Type: object

Result Object

Nested Schema : Object

Type: object

Title: Object

Object with error details information.

500 Response

Internal server error

Body ()

Root Schema : ORSResponse

Type: object

Common response object.

Show Source

• errorData: object ErrorResponseData
  Title: ErrorResponseData

  Error Response Details Information
• result: object result
  Result Object
• status: string
  Status of request

  Example: Success
• version: integer (int32)

{
    "type":"object",
    "properties":{
        "status":{
            "type":"string",
            "description":"Status of request",
            "example":"Success"
        },
        "result":{
            "type":"object",
            "description":"Result Object"
        },
        "errorData":{
            "$ref":"#/components/schemas/ErrorResponseData"
        },
        "version":{
            "type":"integer",
            "format":"int32"
        }
    },
    "description":"Common response object."
}

Nested Schema : ErrorResponseData

Type: object

Title: ErrorResponseData

Error Response Details Information

Show Source

• details: object Object
  Title: Object

  Object with error details information.
• errorCode: string
  Error code which is stored in ErrorCode enum. Example : C1-003

  Example: C1-003
• errorMessage: string
  Error message which is stored in service property file. Example : Cannot modify object after a study version has been approved

  Example: Cannot modify object after a study version has been approved

{
    "title":"ErrorResponseData",
    "type":"object",
    "properties":{
        "errorCode":{
            "type":"string",
            "description":"Error code which is stored in ErrorCode enum. Example : C1-003",
            "example":"C1-003"
        },
        "errorMessage":{
            "type":"string",
            "description":"Error message which is stored in service property file. Example : Cannot modify object after a study version has been approved",
            "example":"Cannot modify object after a study version has been approved"
        },
        "details":{
            "title":"Object",
            "type":"object",
            "description":"Object with error details information."
        }
    },
    "description":"Error Response Details Information"
}

Nested Schema : result

Type: object

Result Object

Nested Schema : Object

Type: object

Title: Object

Object with error details information.

Back to Top