Get all visits, forms, and questions by study ID
get
/ec-designer-svc/rest/v2.0/studies/{studyId}/visitsforms
Get all visits, forms, questions by a study ID and one or more study versions.
Request
Path Parameters
-
studyId(required): string(uuid)
Study ID. Example: F054C951EB74443C93716CA714AB686E
Query Parameters
-
excludeItemType: string
Form Item type to exclude from responseAllowed Values:
[ "instructionalText" ]
-
versions(required): string
comma separated list of study version numbers.
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
200 Response
Successful operation.
Nested Schema : FormDto
Type:
Show Source
object
-
id: string
(uuid)
Form Unique GUID
-
items: array
items
-
refname(required): string
Minimum Length:
1
Maximum Length:64
Form refnameExample:FORM_01
-
studyVersion: string
Study versionExample:
1.0.0.1
-
studyVersionStatus: string
Study version statusExample:
TESTING
-
title(required): string
Minimum Length:
1
Maximum Length:64
Form titleExample:Demography
Nested Schema : items
Type:
Show Source
array
-
Array of:
object FormItemDto v5.0
Title:
FormItemDto v5.0
Discriminator:{ "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtoV5", "numeric":"#/components/schemas/FormNumberItemDtoV5", "measurement":"#/components/schemas/FormNumberItemDtoV5", "text":"#/components/schemas/FormTextItemDtoV5", "choice":"#/components/schemas/FormChoiceItemDtoV5" } }
Form Item Information
Nested Schema : FormItemDto v5.0
Type:
object
Title:
FormItemDto v5.0
Discriminator: questionType
Discriminator Values
Form Item Information
Show Source
-
formId: string
(uuid)
Form Unique GUID
-
formTitle: string
Form titleExample:
Demography
-
formula: string
Smart item formula.Example:
[{'ruleName':'AGE','ruleExpression':'AgeInYears(AGE_DOB_01, visitDate)'}]
-
id: string
(uuid)
Form Item Unique GUID
-
isCohortFactor: boolean
Flag that indicates whether this form item is used as a factor for randomization cohort or not.Example:
false
-
isStrataFactor: boolean
Flag that indicates whether this form item is used as a factor for randomization stratum or not.Example:
false
-
questionHint: string
Minimum Length:
0
Maximum Length:4000
Form question hintExample:What is your age?
-
questionLabel(required): string
Minimum Length:
1
Maximum Length:4000
Form question labelExample:Age
-
questionType(required): string
-
randomizationTag: boolean
Flag that indicates whether this form item should be used for randomization stratification or not.Example:
true
-
refname(required): string
Minimum Length:
1
Maximum Length:64
Form item reference name.Example:NUMBER_01
-
required(required): boolean
Whether this form item is requiered or not.Example:
true
-
ruleSet: string
A JSON-formatted set of rules to do validation of the answers.Example:
{'logicalOperator':'NONE','rules':[],'numberIndex':1}
-
sdvRequired(required): boolean
Source-Documented Verification: Whether proof of the answer required?Example:
false
-
sequence: integer
(int32)
Item position in the form.Example:
1
-
smartItemId: string
(uuid)
Smart item Unique GUID
-
smartObject: string
Smart object.Example:
AGE
Match One Schema
Show Source
-
object
FormNumberItemDto v5.0
Title:
FormNumberItemDto v5.0
Form Number Item Details Information -
object
FormChoiceItemDto v5.0
Title:
FormChoiceItemDto v5.0
Form Choice Item Details Information -
object
FormTextItemDto v5.0
Title:
FormTextItemDto v5.0
Form text Item Details Information -
object
FormDatetimeItemDto v5.0
Title:
FormDatetimeItemDto v5.0
Form DateTime Item Details Information
Nested Schema : FormNumberItemDto v5.0
Type:
object
Title:
FormNumberItemDto v5.0
Form Number Item Details Information
Match All
Form Number Item Details Information
Form Number Item Details Information
Show Source
-
object
FormItemDto v5.0
Title:
FormItemDto v5.0
Discriminator:{ "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtoV5", "numeric":"#/components/schemas/FormNumberItemDtoV5", "measurement":"#/components/schemas/FormNumberItemDtoV5", "text":"#/components/schemas/FormTextItemDtoV5", "choice":"#/components/schemas/FormChoiceItemDtoV5" } }
Form Item Information -
object
FormNumberItemDto v5.0-allOf[1]
Nested Schema : FormChoiceItemDto v5.0
Type:
object
Title:
FormChoiceItemDto v5.0
Form Choice Item Details Information
Match All
Form Choice Item Details Information
Form Choice Item Details Information
Show Source
-
object
FormItemDto v5.0
Title:
FormItemDto v5.0
Discriminator:{ "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtoV5", "numeric":"#/components/schemas/FormNumberItemDtoV5", "measurement":"#/components/schemas/FormNumberItemDtoV5", "text":"#/components/schemas/FormTextItemDtoV5", "choice":"#/components/schemas/FormChoiceItemDtoV5" } }
Form Item Information -
object
FormChoiceItemDto v5.0-allOf[1]
Nested Schema : FormTextItemDto v5.0
Type:
object
Title:
FormTextItemDto v5.0
Form text Item Details Information
Match All
Form text Item Details Information
Form text Item Details Information
Show Source
-
object
FormItemDto v5.0
Title:
FormItemDto v5.0
Discriminator:{ "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtoV5", "numeric":"#/components/schemas/FormNumberItemDtoV5", "measurement":"#/components/schemas/FormNumberItemDtoV5", "text":"#/components/schemas/FormTextItemDtoV5", "choice":"#/components/schemas/FormChoiceItemDtoV5" } }
Form Item Information -
object
FormTextItemDto v5.0-allOf[1]
Nested Schema : FormDatetimeItemDto v5.0
Type:
object
Title:
FormDatetimeItemDto v5.0
Form DateTime Item Details Information
Match All
Form DateTime Item Details Information
Form DateTime Item Details Information
Show Source
-
object
FormItemDto v5.0
Title:
FormItemDto v5.0
Discriminator:{ "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtoV5", "numeric":"#/components/schemas/FormNumberItemDtoV5", "measurement":"#/components/schemas/FormNumberItemDtoV5", "text":"#/components/schemas/FormTextItemDtoV5", "choice":"#/components/schemas/FormChoiceItemDtoV5" } }
Form Item Information -
object
FormDatetimeItemDto v5.0-allOf[1]
Nested Schema : FormNumberItemDto v5.0-allOf[1]
Type:
Show Source
object
-
precision: integer
(int32)
Minimum Value:
0
Number value precisionExample:1
-
units: string
Units of measureExample:
kg
Nested Schema : FormChoiceItemDto v5.0-allOf[1]
Type:
Show Source
object
-
display: string
Pattern:
selectbox
Form choice item display in UI - Selectbox.Example:selectbox
-
options: array
options
Nested Schema : options
Type:
Show Source
array
-
Array of:
object FormOptionDto v5.0
Title:
FormOptionDto v5.0
Form choice item option details
Nested Schema : FormOptionDto v5.0
Type:
object
Title:
FormOptionDto v5.0
Form choice item option details
Show Source
-
label: string
Minimum Length:
1
Maximum Length:4000
Form choice selectbox label for a one specific choice.Example:Female
-
value: string
Minimum Length:
1
Maximum Length:4000
Pattern:[a-zA-Z0-9]+
Form choice selectbox value for a one specific choice.Example:1
Nested Schema : FormTextItemDto v5.0-allOf[1]
Type:
Show Source
object
-
maxlength: integer
(int32)
Minimum Value:
0
Maximum Value:4000
Form text item max lengthExample:4000
-
multiline: boolean
Is form text item multilineExample:
false
Nested Schema : FormDatetimeItemDto v5.0-allOf[1]
Type:
Show Source
object
-
allowPartialDate: integer
(int32)
Minimum Value:
0
Maximum Value:1
Allow partial dateExample:1
-
format: string
Pattern:
yyyy|MMM-yyyy|dd-MMM-yyyy|dd-MMM-yyyy HH:mm
Date time formatExample:DD-MON-YYYY
-
partialDate: string
Pattern:
yyyy|MMM-yyyy
Partial date formatExample:Jan-1993
Nested Schema : FormItemBasicDto
Type:
Show Source
object
-
formId: string
(uuid)
Form Unique GUID
-
formTitle: string
Form titleExample:
Demography
-
formula: string
Smart item formula.Example:
[{'ruleName':'AGE','ruleExpression':'AgeInYears(AGE_DOB_01, visitDate)'}]
-
id: string
(uuid)
Form Item Unique GUID
-
isCohortFactor: boolean
Flag that indicates whether this form item is used as a factor for randomization cohort or not.Example:
false
-
isStrataFactor: boolean
Flag that indicates whether this form item is used as a factor for randomization stratum or not.Example:
false
-
questionHint: string
Minimum Length:
0
Maximum Length:4000
Form question hintExample:What is your age?
-
questionLabel(required): string
Minimum Length:
1
Maximum Length:4000
Form question labelExample:Age
-
questionType: string
Form Question typeExample:
TEXT
-
randomizationTag: boolean
Flag that indicates whether this form item should be used for randomization stratification or not.Example:
true
-
refname(required): string
Minimum Length:
1
Maximum Length:64
Form item reference name.Example:NUMBER_01
-
required(required): boolean
Whether this form item is requiered or not.Example:
true
-
ruleSet: string
A JSON-formatted set of rules to do validation of the answers.Example:
{'logicalOperator':'NONE','rules':[],'numberIndex':1}
-
sdvRequired(required): boolean
Source-Documented Verification: Whether proof of the answer required?Example:
false
-
sequence: integer
(int32)
Item position in the form.Example:
1
-
smartItemId: string
(uuid)
Smart item Unique GUID
-
smartObject: string
Smart object.Example:
AGE
-
studyVersion: string
Study versionExample:
1.0.0.1
-
studyVersionStatus: string
Study version statusExample:
TESTING
Nested Schema : VisitDto
Type:
Show Source
object
-
endVisitId: string
(uuid)
End visit ID
-
eventType: string
Visit event typeExample:
ScreeningVisit
-
id: string
(uuid)
Visit GUID
-
lastRequired: boolean
Yes - if Visit is last required.Example:
false
-
randomization: string
(uuid)
Randomization GUID
-
repeatNumber(required): integer
(int32)
Times to repeat Visit Design.Example:
5
-
repeatVisit(required): boolean
Yes - if Visit Design is repeating.Example:
false
-
requiredVisit(required): boolean
Yes - if Visit Design is required.Example:
false
-
shortName(required): string
Minimum Length:
1
Maximum Length:16
Pattern:[a-zA-Z0-9]+
Visit short nameExample:Week1
-
startVisitId: string
(uuid)
Start visit ID
-
studyVersion: string
Study versionExample:
1.0.0.1
-
studyVersionStatus: string
Study version statusExample:
TESTING
-
title(required): string
Minimum Length:
1
Maximum Length:64
Visit titleExample:Week 2
-
visitDescription: string
Visit descriptionExample:
Regular 2 week visit
-
visitStartDate: string
(date-time)
Visit start date timeExample:
2019-01-25T07:42:00.204Z
500 Response
Error
Nested Schema : details
Type:
object