Get a shipment's details by ID for a site
get
/ec-ors-svc/rest/v3.0/studies/{studyId}/{mode}/sites/{siteId}/shipments/{shipmentId}
Retrieves a shipments' details by ID for a site. Rights: OrsSupplyManagerGet and OrsBlinded. Added additional attributes: versionStart and userId
Request
Path Parameters
-
mode(required): string
Mode of the study, accepts: test, active, or training
-
shipmentId(required): string(uuid)
ID of the shipment.
-
siteId(required): string(uuid)
ID of the site
-
studyId(required): string(uuid)
ID of the study
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
200 Response
Successful operation
Root Schema : SiteUserShipmentTOV3
Type:
objectResponse object containing details about shipment at a site.
Show Source
-
availableCount: integer
(int64)
Available kits count.Example:
5 -
createdDate: string
(date-time)
Shipment creation date
-
damagedCount: integer
(int64)
Damaged kits count.Example:
5 -
depotId: string
(uuid)
Depot Id
-
depotName: string
Name of the depot.Example:
Depot Houston -
depotShortName: string
Short identifier for the depot, such as a number.Example:
123 -
inTransitCount: integer
(int64)
In transit kits count.Example:
5 -
missingCount: integer
(int64)
Missing kits count.Example:
5 -
preQuarantinedCount: integer
(int64)
Pre quarantined kits count.Example:
5 -
reconciliation: boolean
Indicate if kit reconciliation is there.Example:
true -
reportId: string
Report Id.Example:
B1B8327AFAA6412287106192AB5984EF -
shipDate: string
(date-time)
Ship date.
-
shipmentId: string
ID of the shipment.Example:
123 -
shipmentNumber: string
Shipment number.Example:
123 -
siteId: string
(uuid)
ID of the site
-
siteName: string
Name of the site.Example:
Site Houston -
siteShortName: string
Short identifier for the site, such as a number.Example:
12 -
statusDate: string
(date-time)
Status date.
-
statusId: number
(Integer)
Shipment status Id.Example:
5 -
trackingNumber: string
Shipment tracking number.Example:
12345 -
trackingNumberURL: string
Shipment tracking url.Example:
http://www.site.com -
userId: string
(uuid)
User Id
-
versionStart: string
(date-time)
Version start date
404 Response
'Invalid study ID', 'Study still in Draft (design phase)', 'Invalid site ID', 'Invalid shipment ID'
Root Schema : DesignerResponse
Type:
Show Source
object-
errorData: object
ErrorResponseData
Structure representing an error response from the reporting service. Contains an error code, human-readable message, and details.
-
result: object
result
-
status: string
-
version: integer
(int32)
Nested Schema : ErrorResponseData
Type:
objectStructure representing an error response from the reporting service. Contains an error code, human-readable message, and details.
Show Source
-
details: string
Detailed error context or debugging information such as validation error, stack trace, or field/parameter cause.Example:
User role is missing required permission REPORTING_VIEW. Field: userId -
errorCode: string
Application or business-specific error code representing the error type.Example:
REPT_401 -
errorMessage: string
Human-readable error message describing the failure or issue.Example:
Unauthorized: User does not have access to the requested resource
Nested Schema : result
Type:
object500 Response
Internal server error
Root Schema : DesignerResponse
Type:
Show Source
object-
errorData: object
ErrorResponseData
Structure representing an error response from the reporting service. Contains an error code, human-readable message, and details.
-
result: object
result
-
status: string
-
version: integer
(int32)
Nested Schema : ErrorResponseData
Type:
objectStructure representing an error response from the reporting service. Contains an error code, human-readable message, and details.
Show Source
-
details: string
Detailed error context or debugging information such as validation error, stack trace, or field/parameter cause.Example:
User role is missing required permission REPORTING_VIEW. Field: userId -
errorCode: string
Application or business-specific error code representing the error type.Example:
REPT_401 -
errorMessage: string
Human-readable error message describing the failure or issue.Example:
Unauthorized: User does not have access to the requested resource
Nested Schema : result
Type:
object