REST API for Clinical One Platform

Search for kits in a given range for a site

get

/ec-ors-svc/rest/v5.0/studies/{studyId}/{mode}/sites/{siteId}/inventory/kits

Retrieves kits for a site based o a given number range. Kit Range should be specified in the format as KIT_NUMBER:{From Kit number}:{To Kit number}. e.g. KIT_NUMBER:1:100.
Rights: OrsInventoryGet and either OrsUnblinded or OrsBlinded.

Request

Path Parameters

mode(required): string

Mode of the study, accepts: test, active, or training
siteId(required): string(uuid)

ID of the site
studyId(required): string(uuid)

ID of the study

Query Parameters

inventoryStatusId(required): array[integer]

A list of IDs of the inventory status
kitRange(required): string

Range of the kit
limit: string

Maximum number of records to display per page.

Default Value: 100
offset: string

An order number to specify with which object you want to start retrieving result. If provided, you also need to specify a value for the limit parameter. Offset is affected by the value of the order parameter

Default Value: 0
searchString(required): string

Search string
subjectId(required): string(uuid)

ID of the subject

There's no request body for this operation.

Response

Supported Media Types

application/json

200 Response

Successful operation

Root Schema : SiteKitDetailsResponseV1

Type: object

Title: SiteKitDetailsResponseV1

Contains site kit detail.

Show Source

count: integer (int64)

Total count of result
hasMore: boolean

Attribute describes if result set has more records

Example: true
kits: array kits

Title: kits

Contains site user inventory.
limit: integer (int64)

Maximum number of records to display per page.
links: array links
maxKitNumber: integer (int32)

Maximum Kit number

Example: 10
minKitNumber: integer (int32)

Minimum Kit number

Example: 10
offset: integer (int64)

An order number to specify with which object you want to start retrieving result. If provided, you also need to specify a value for the limit parameter. Offset is affected by the value of the order parameter

Example: 400
totalResults: integer (int64)

Total number of entities in response

{
    "title":"SiteKitDetailsResponseV1",
    "type":"object",
    "properties":{
        "minKitNumber":{
            "type":"integer",
            "description":"Minimum Kit number",
            "format":"int32",
            "example":"10"
        },
        "maxKitNumber":{
            "type":"integer",
            "description":"Maximum Kit number",
            "format":"int32",
            "example":"10"
        },
        "kits":{
            "title":"kits",
            "type":"array",
            "description":"Contains site user inventory.",
            "items":{
                "$ref":"#/components/schemas/SiteUserInventoryTO"
            }
        },
        "count":{
            "type":"integer",
            "description":"Total count of result",
            "format":"int64"
        },
        "hasMore":{
            "type":"boolean",
            "description":"Attribute describes if result set has more records",
            "example":true
        },
        "totalResults":{
            "type":"integer",
            "description":"Total number of entities in response",
            "format":"int64"
        },
        "limit":{
            "type":"integer",
            "description":"Maximum number of records to display per page.",
            "format":"int64"
        },
        "offset":{
            "type":"integer",
            "description":"An order number to specify with which object you want to start retrieving result. If provided, you also need to specify a value for the limit parameter. Offset is affected by the value of the order parameter",
            "format":"int64",
            "example":"400"
        },
        "links":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/RelLink"
            }
        }
    },
    "description":"Contains site kit detail."
}

Nested Schema : kits

Type: array

Title: kits

Contains site user inventory.

Show Source

Array of: object SiteUserInventoryTO

Contains site inventory detail.

{
    "title":"kits",
    "type":"array",
    "description":"Contains site user inventory.",
    "items":{
        "$ref":"#/components/schemas/SiteUserInventoryTO"
    }
}

Nested Schema : links

Type: array

Show Source

Array of: object RelLink

Object contains link detail.

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

Nested Schema : SiteUserInventoryTO

Type: object

Contains site inventory detail.

Show Source

comment: string

Comment for shipment

Example: Some description
id: string

Unique id for inventory

Example: B1B8327AFAA6412287106192AB5984EF
inventoryStatus: string

Inventory status

Example: Dispensed
inventoryStatusId: integer (int32)

Allowed Values: [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20" ]

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)

Kit/Lot number

Example: 10
receivedDate: string

Shipment received date

Example: 2016-11-14T23:36:32.079Z
shipmentId: string

Order(shipment) Id

Example: B1B8327AFAA6412287106192AB5984EF
shipmentNumber: string

Shipment Number

Example: 12345

{
    "type":"object",
    "properties":{
        "kitNumber":{
            "type":"number",
            "description":"Kit/Lot number",
            "format":"BigDecimal",
            "example":"10"
        },
        "inventoryStatusId":{
            "type":"integer",
            "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":"int32",
            "example":"10",
            "enum":[
                "1",
                "2",
                "3",
                "4",
                "5",
                "6",
                "7",
                "8",
                "9",
                "10",
                "11",
                "12",
                "13",
                "14",
                "15",
                "16",
                "17",
                "18",
                "19",
                "20"
            ]
        },
        "inventoryStatus":{
            "type":"string",
            "description":"Inventory status",
            "example":"Dispensed"
        },
        "shipmentNumber":{
            "type":"string",
            "description":"Shipment Number",
            "example":"12345"
        },
        "receivedDate":{
            "type":"string",
            "description":"Shipment received date",
            "example":"2016-11-14T23:36:32.079Z"
        },
        "comment":{
            "type":"string",
            "description":"Comment for shipment",
            "example":"Some description"
        },
        "id":{
            "type":"string",
            "description":"Unique id for inventory",
            "example":"B1B8327AFAA6412287106192AB5984EF"
        },
        "shipmentId":{
            "type":"string",
            "description":"Order(shipment) Id",
            "example":"B1B8327AFAA6412287106192AB5984EF"
        }
    },
    "description":"Contains site inventory detail."
}

Nested Schema : RelLink

Type: object

Object contains link detail.

Show Source

href: string

Realtive URL
rel: string

link

{
    "type":"object",
    "properties":{
        "rel":{
            "type":"string",
            "description":"link"
        },
        "href":{
            "type":"string",
            "description":"Realtive URL"
        }
    },
    "description":"Object contains link detail."
}

400 Response

For invalid kit range format

Root Schema : ORSResponse

Type: object

Common response object.

Show Source

errorData: object ErrorResponseData
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

Show Source

details: object details
errorCode: string
errorMessage: string

{
    "type":"object",
    "properties":{
        "errorCode":{
            "type":"string"
        },
        "errorMessage":{
            "type":"string"
        },
        "details":{
            "type":"object"
        }
    }
}

Nested Schema : result

Type: object

Result Object

Nested Schema : details

Type: object

404 Response

For invalid study ID OR study still in design phase OR invalid site ID OR invalid subject ID

Root Schema : ORSResponse

Type: object

Common response object.

Show Source

errorData: object ErrorResponseData
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

Show Source

details: object details
errorCode: string
errorMessage: string

{
    "type":"object",
    "properties":{
        "errorCode":{
            "type":"string"
        },
        "errorMessage":{
            "type":"string"
        },
        "details":{
            "type":"object"
        }
    }
}

Nested Schema : result

Type: object

Result Object

Nested Schema : details

Type: object

500 Response

Internal server error

Root Schema : ORSResponse

Type: object

Common response object.

Show Source

errorData: object ErrorResponseData
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

Show Source

details: object details
errorCode: string
errorMessage: string

{
    "type":"object",
    "properties":{
        "errorCode":{
            "type":"string"
        },
        "errorMessage":{
            "type":"string"
        },
        "details":{
            "type":"object"
        }
    }
}

Nested Schema : result

Type: object

Result Object

Nested Schema : details

Type: object