Jump to

• Request
• Response

Get a list of study visits

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. Example: F054C951EB74443C93716CA714AB686E
• version(required): string
  Study version. Example: "1.0.0.1"

Query Parameters

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

  Allowed Values: [ "test", "training", "active" ]
• sort: boolean
  Get visits sorted

  Default Value: 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/Study Visit DTO V2"
    }
}

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"
}

500 Response

Error

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