Jump to

• Request
• Response

v2.0

get

/ec-ors-svc/rest/v2.0/studies/{studyId}/{mode}/unblinded-disp-history

Deprecated: Retrieves unblinded dispensation history for all subjects within the study. Rights: OrsSubjectVisitGet.

Request

Path Parameters

• mode(required): string
  Mode of the study, accepts: test, active, or training.
• studyId(required): string(uuid)
  Unique identifier (UUID, 32-character uppercase hexadecimal string) representing the study.

Query Parameters

• audit: boolean
  Value of audit parameter
• instanceNumber: number
  Instance number for unscheduled visit.
• subjectId: string
  Unique subject identifier (UUID, 32-character uppercase hexadecimal string) representing the patient/participant enrolled in the study.
• visitId: string
  Unique identifier (UUID, 32-character uppercase hexadecimal string) of the visit

There's no request body for this operation.

Back to Top

Response

Supported Media Types

• application/json

200 Response

Successful operation

Body ()

Root Schema : DispensationHistoryResponseForAllSubject v2.0

Type: object

Title: DispensationHistoryResponseForAllSubject v2.0

Contains unblinded dispensation history for all subjects.

Show Source

• barcode: string
  Barcode.
• conserved: boolean
  Conserved for dispensation.
• dispensationConfirmed: boolean
  Indicates whether dispensation is confirmed.
• dispensationDate: string (date-time)
  Dispensation date.
• dose: number
  Dose.
• frequency: string
  Frequency
• instanceNumber: number
  Title: Instance Number

  Visit instance number.
• inventoryId: string (uuid)
  Inventory ID.
• inventoryStatus: string
  Name of the inventory status.
• inventoryStatusId: number
  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: 5
• kitNumber: number
  Title: Kit Number

  Kit number.
• kitNumberUTF: string
  Title: Kit Number UTF

  Kit number with UTF-8 support.
• kitTypeSrcId: string (uuid)
  Title: Kit Type Source ID

  Kit type ID.
• measurement: string
  Measurement unit
• mHealthDeviceId: string
  mHealthDevice Id
• missingUnits: number
  Missing units for the kit.
• objectVersionNumber: number (double)
  Object version number.
• returnedUnits: number
  Returned units for the kit.
• siteId: string (uuid)
  Site ID.
• subjectId: string (uuid)
  Title: Subject ID

  Subject ID.
• versionEnd: string (date-time)
  Version end date.
• versionStart: string (date-time)
  Version start date.
• visitId: string (uuid)
  Title: Visit Source ID

  Visit source identifier.

{
    "title":"DispensationHistoryResponseForAllSubject v2.0",
    "type":"object",
    "properties":{
        "subjectId":{
            "title":"Subject ID",
            "type":"string",
            "description":"Subject ID.",
            "format":"uuid"
        },
        "visitId":{
            "title":"Visit Source ID",
            "type":"string",
            "description":"Visit source identifier.",
            "format":"uuid"
        },
        "instanceNumber":{
            "title":"Instance Number",
            "type":"number",
            "description":"Visit instance number."
        },
        "siteId":{
            "type":"string",
            "description":"Site ID.",
            "format":"uuid"
        },
        "inventoryId":{
            "type":"string",
            "description":"Inventory ID.",
            "format":"uuid"
        },
        "kitNumber":{
            "title":"Kit Number",
            "type":"number",
            "description":"Kit number."
        },
        "kitTypeSrcId":{
            "title":"Kit Type Source ID",
            "type":"string",
            "description":"Kit type ID.",
            "format":"uuid"
        },
        "inventoryStatusId":{
            "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).",
            "example":5
        },
        "inventoryStatus":{
            "type":"string",
            "description":"Name of the inventory status."
        },
        "dispensationDate":{
            "type":"string",
            "description":"Dispensation date.",
            "format":"date-time"
        },
        "barcode":{
            "type":"string",
            "description":"Barcode."
        },
        "dispensationConfirmed":{
            "type":"boolean",
            "description":"Indicates whether dispensation is confirmed."
        },
        "mHealthDeviceId":{
            "type":"string",
            "description":"mHealthDevice Id"
        },
        "dose":{
            "type":"number",
            "description":"Dose."
        },
        "measurement":{
            "type":"string",
            "description":"Measurement unit"
        },
        "frequency":{
            "type":"string",
            "description":"Frequency"
        },
        "returnedUnits":{
            "type":"number",
            "description":"Returned units for the kit."
        },
        "missingUnits":{
            "type":"number",
            "description":"Missing units for the kit."
        },
        "conserved":{
            "type":"boolean",
            "description":"Conserved for dispensation."
        },
        "kitNumberUTF":{
            "title":"Kit Number UTF",
            "type":"string",
            "description":"Kit number with UTF-8 support."
        },
        "versionStart":{
            "type":"string",
            "description":"Version start date.",
            "format":"date-time"
        },
        "objectVersionNumber":{
            "type":"number",
            "description":"Object version number.",
            "format":"double"
        },
        "versionEnd":{
            "type":"string",
            "description":"Version end date.",
            "format":"date-time"
        }
    },
    "description":"Contains unblinded dispensation history for all subjects."
}

404 Response

Invalid study ID or version. Or subject not found.

Body ()

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

Body ()

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

Back to Top