REST API for Clinical One Platform

Get a subject's events within a date range

get

/ec-dataintegration-svc/rest/v3.0/studies/{studyId}/{mode}/subjects/dateRange/{subjectId}

Retrieves the events for a specific subject within a specified date range. New properties are withdrawl/completion date and ehr link statusUsed by Integration Hub to retrieve events associated with a specific subject. Rights: DataCaptureSubjectIntegrationGet and SubjectDataClassificationGet.

Request

Path Parameters

subjectId(required): string(uuid)

ID for the subject whose events you want to retrieve, as it appears in Clinical One.

Query Parameters

endDate: string(date-time)

The ending date and time (optional) for which you want to get events. If you don't specify the time, the date range stops before midnight (23:59:59 UTC) for the specified date. The accepted date and time formats are: dd-MMM-yyyy HH:mm:ss.SSS, dd-MMM-yyyy HH:mm:ss, dd-MMM-yyyy HH:mm, or dd-MMM-yyyy.
startDate: string(date-time)

The starting date and time (optional) for which you want to get events. If you don't specify the time, the date range begins after midnight (UTC) for the specified date. The accepted date and time formats are: dd-MMM-yyyy HH:mm:ss.SSS, dd-MMM-yyyy HH:mm:ss, dd-MMM-yyyy HH:mm, or dd-MMM-yyyy.

There's no request body for this operation.

Response

Supported Media Types

application/json

200 Response

Subjects success.

Root Schema : schema

Type: array

Show Source

Array of: object SubjectRespDto13

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

Nested Schema : SubjectRespDto13

Type: object

Show Source

canBeCompleted: boolean
codeBreak: string
comment: string

Minimum Length: 0

Maximum Length: 2048
description: string

Minimum Length: 0

Maximum Length: 500
dob: string (date-time)
ehrLinkStatus: number
enrollmentFailure: string

Minimum Length: 0

Maximum Length: 255
enrollmentOverride: string

Minimum Length: 0

Maximum Length: 255
eventType: string
freezedStatus: string
fromStudyId: string (uuid)
gender: string

Minimum Length: 0

Maximum Length: 10
hasLockData: boolean
id: string (uuid)
informedConsentDate: string (date-time)
lastSigned: string
lockedDateTime: string (date-time)
lockedInStudyVersion: string
lockedStatus: string
mhealthSubjectId: string (uuid)
objectVersionNumber: number
operationType: string
previousSubjectNumber: string
randomizationNumber: string
reason: string

Minimum Length: 0

Maximum Length: 255
screenFailureComment: string
screenFailureDate: string (date-time)
screeningDate: string (date-time)
screeningFailure: string

Minimum Length: 0

Maximum Length: 255
screeningNumber: string
signedStatus: string
siteId: string
softwareVersionNumber: number
sourceTimeStamp: string (date-time)
state(required): string

Minimum Length: 0

Maximum Length: 100
stateDate: string (date-time)
studyCompletionDate: string (date-time)
studyId: string
studyVersion(required): string
subjectNumber(required): string

Minimum Length: 0

Maximum Length: 500
subjectSiteSerialNumber: string
subjectStudySerialNumber: string
subjectTransferId: string (uuid)
subjNumSiteOrgId: string
userId: string (uuid)
verifiedStatus: string
versionEnd: string (date-time)
versionStart: string (date-time)
withdrawalComment: string
withdrawalDate: string (date-time)
withdrawalReason: string

{
    "required":[
        "state",
        "studyVersion",
        "subjectNumber"
    ],
    "type":"object",
    "properties":{
        "screeningDate":{
            "type":"string",
            "format":"date-time"
        },
        "codeBreak":{
            "type":"string"
        },
        "userId":{
            "type":"string",
            "format":"uuid"
        },
        "eventType":{
            "type":"string"
        },
        "subjectTransferId":{
            "type":"string",
            "format":"uuid"
        },
        "objectVersionNumber":{
            "type":"number"
        },
        "mhealthSubjectId":{
            "type":"string",
            "format":"uuid"
        },
        "fromStudyId":{
            "type":"string",
            "format":"uuid"
        },
        "subjNumSiteOrgId":{
            "type":"string"
        },
        "signedStatus":{
            "type":"string"
        },
        "verifiedStatus":{
            "type":"string"
        },
        "freezedStatus":{
            "type":"string"
        },
        "lastSigned":{
            "type":"string"
        },
        "softwareVersionNumber":{
            "type":"number"
        },
        "operationType":{
            "type":"string"
        },
        "subjectStudySerialNumber":{
            "type":"string"
        },
        "subjectSiteSerialNumber":{
            "type":"string"
        },
        "versionEnd":{
            "type":"string",
            "format":"date-time"
        },
        "previousSubjectNumber":{
            "type":"string"
        },
        "screenFailureDate":{
            "type":"string",
            "format":"date-time"
        },
        "lockedStatus":{
            "type":"string"
        },
        "hasLockData":{
            "type":"boolean"
        },
        "lockedDateTime":{
            "type":"string",
            "format":"date-time"
        },
        "canBeCompleted":{
            "type":"boolean"
        },
        "lockedInStudyVersion":{
            "type":"string"
        },
        "id":{
            "type":"string",
            "format":"uuid"
        },
        "versionStart":{
            "type":"string",
            "format":"date-time"
        },
        "description":{
            "maxLength":500,
            "minLength":0,
            "type":"string"
        },
        "subjectNumber":{
            "maxLength":500,
            "minLength":0,
            "type":"string"
        },
        "studyId":{
            "type":"string"
        },
        "siteId":{
            "type":"string"
        },
        "dob":{
            "type":"string",
            "format":"date-time"
        },
        "state":{
            "maxLength":100,
            "minLength":0,
            "type":"string"
        },
        "stateDate":{
            "type":"string",
            "format":"date-time"
        },
        "screeningFailure":{
            "maxLength":255,
            "minLength":0,
            "type":"string"
        },
        "enrollmentFailure":{
            "maxLength":255,
            "minLength":0,
            "type":"string"
        },
        "enrollmentOverride":{
            "maxLength":255,
            "minLength":0,
            "type":"string"
        },
        "informedConsentDate":{
            "type":"string",
            "format":"date-time"
        },
        "gender":{
            "maxLength":10,
            "minLength":0,
            "type":"string"
        },
        "reason":{
            "maxLength":255,
            "minLength":0,
            "type":"string"
        },
        "comment":{
            "maxLength":2048,
            "minLength":0,
            "type":"string"
        },
        "studyVersion":{
            "type":"string"
        },
        "sourceTimeStamp":{
            "type":"string",
            "format":"date-time"
        },
        "screeningNumber":{
            "type":"string"
        },
        "randomizationNumber":{
            "type":"string"
        },
        "withdrawalReason":{
            "type":"string"
        },
        "ehrLinkStatus":{
            "type":"number"
        },
        "withdrawalDate":{
            "type":"string",
            "format":"date-time"
        },
        "studyCompletionDate":{
            "type":"string",
            "format":"date-time"
        },
        "withdrawalComment":{
            "type":"string"
        },
        "screenFailureComment":{
            "type":"string"
        }
    }
}

400 Response

Bad request.

Root Schema : RestResponse

Type: object

Show Source

errorData: object ErrorResponseData

Title: ErrorResponseData

Error Response Details Information
result: object result
status: string
version: integer (int32)

{
    "type":"object",
    "properties":{
        "status":{
            "type":"string"
        },
        "result":{
            "type":"object"
        },
        "version":{
            "type":"integer",
            "format":"int32",
            "writeOnly":true
        },
        "errorData":{
            "$ref":"#/components/schemas/ErrorResponseData"
        }
    }
}

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

Nested Schema : Object

Type: object

Title: Object

Object with error details information.