Jump to

• Request
• Response

V2.0

get

/ec-designer-svc/rest/v2.0/studies/{studyId}/visits

Retrieves a list of visits in a study.

Request

Path Parameters

• studyId(required): string(uuid)
  Study ID (UUID, 32-character uppercase hexadecimal string). Required.

  Example:

  F054C951EB74443C93716CA714AB686E

• version(required): string
  Study version path segment. Required. Example: "1.0.0.1".

  Example:

  1.0.0.1

Query Parameters

• mode(required): string
  Study mode to filter visits.

  Allowed Values: [ "test", "training", "active" ]

  Example:

  test

• sort: boolean
  Get visits sorted Optional.

  Default Value: false

  Example:

  false

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 StudyVisitDto v2.0
  Title: StudyVisitDto v2.0

  Reduced Visit and branch properties

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

Nested Schema : StudyVisitDto v2.0

Type: object

Title: StudyVisitDto v2.0

Reduced Visit and branch properties

Show Source

• branchIsCycle: boolean
  The branch is cyclic or acyclic

  Example: true
• branchShortName: string
  Visit Branch shortName

  Example: Br1
• branchTitle: string
  Branch title

  Example: Branch1
• cycleCount: number
  number of times a branch can cycle

  Example: 10
• eventType: string
  Visit event type

  Example: ScreeningVisit
• fullName: string
  Concatenation of Visit Title and Branch title with hypen

  Example: B1C01 - V01
• id: string (uuid)
  Branch GUID
• shortName: string
  Visit shortname

  Example: W2
• startCycle: integer (int32)
  Start Cycle Number
• title: string
  Visit title

  Example: Week2

{
    "title":"StudyVisitDto v2.0",
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"Branch GUID",
            "format":"uuid"
        },
        "title":{
            "type":"string",
            "description":"Visit title",
            "example":"Week2"
        },
        "shortName":{
            "type":"string",
            "description":"Visit shortname",
            "example":"W2"
        },
        "fullName":{
            "type":"string",
            "description":"Concatenation of Visit Title and Branch title with hypen",
            "example":"B1C01 - V01"
        },
        "eventType":{
            "type":"string",
            "description":"Visit event type",
            "example":"ScreeningVisit"
        },
        "branchTitle":{
            "type":"string",
            "description":"Branch title",
            "example":"Branch1"
        },
        "branchShortName":{
            "type":"string",
            "description":"Visit Branch shortName",
            "example":"Br1"
        },
        "branchIsCycle":{
            "type":"boolean",
            "description":"The branch is cyclic or acyclic",
            "example":true
        },
        "startCycle":{
            "type":"integer",
            "description":"Start Cycle Number",
            "format":"int32"
        },
        "cycleCount":{
            "type":"number",
            "description":"number of times a branch can cycle",
            "example":10
        }
    },
    "description":"Reduced Visit and branch properties"
}

Examples

Select an example successResponse

500 Response

Returned when the request cannot be completed due to validation failure, authorization failure, or an unexpected server-side condition.

Body ()

Root 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 : details

Type: object

Back to Top