Get visit summary with form and item IDs
post
/ec-designer-edc-svc/rest/v1.0/studies/{studyId}/visitsforms/formitems
Retrieves visit summary with form and item IDs.
Request
Path Parameters
-
studyId(required): string(uuid)
Study ID. Example: F054C951EB74443C93716CA714AB686E
Query Parameters
-
excludeItemType: string
Form Item type to exclude from responseAllowed Values:
[ "instructionalText" ]
-
formCategory: string
Return forms with this Form Category.Default Value:
ALL
Allowed Values:[ "DCS", "NSF", "ALL" ]
-
forms: boolean
Include froms in responseDefault Value:
true
-
items: string
Default Value:
all
-
mode(required): string
Study mode to filter study forms.Allowed Values:
[ "test", "training", "active" ]
-
visits: boolean
Include visits in responseDefault Value:
true
Supported Media Types
- */*
Nested Schema : StudyVersionVisitDtoV9
Type:
Show Source
object
-
studyId: string
(uuid)
-
studyTitle: string
Study nameExample:
Study 03
-
version: string
versionExample:
1.3.0.6
-
versionPreviousStatus: string
Allowed Values:
[ "DRAFT", "TESTING", "APPROVED", "ARCHIVED" ]
Previous study statusExample:TESTING
-
versionStatus: string
Study version statusExample:
Active, not recruiting
-
visitId: string
(uuid)
Visit GUID
Response
Supported Media Types
- application/json
200 Response
Successful operation.
Nested Schema : forms
Type:
Show Source
array
-
Array of:
object FormSummaryDto v1.0
Title:
FormSummaryDto v1.0
Reduced form properties
Nested Schema : FormSummaryDto v1.0
Type:
object
Title:
FormSummaryDto v1.0
Reduced form properties
Show Source
-
id: string
(uuid)
Form Unique GUID
-
items: array
items
-
refname: string
Form refnameExample:
FORM_01
-
title: string
Form titleExample:
Demography
Nested Schema : items
Type:
Show Source
array
-
Array of:
object FormItemSummaryDto v1.0
Title:
FormItemSummaryDto v1.0
Reduced form item properties
Nested Schema : FormItemSummaryDto v1.0
Type:
object
Title:
FormItemSummaryDto v1.0
Reduced form item properties
Show Source
-
id: string
(uuid)
Form Item Unique GUID
-
questionLabel: string
Form question labelExample:
Age
-
questionType: string
Title:
FormItemType
Allowed Values:[ "text", "instructionalText", "numeric", "datetime", "choice", "questionGroup", "table", "label", "section", "existingData" ]
Question typeExample:numeric
-
refname: string
Form item reference name.Example:
NUMBER_01
-
subItemIds: string
(uuid)
Title:
Sub item ids
List of sub question ids
Nested Schema : VisitSummaryWithFormIdsDto
Type:
Show Source
object
-
branchCycleCount(required): number
-
branchId: string
(uuid)
-
branchIndex: integer
(int32)
-
branchIsCycle: boolean
-
branchShortName: string
-
branchStartCycle(required): integer
(int32)
-
branchTier: integer
(int32)
-
branchTitle: string
-
eventType: string
-
formIds: array
formIds
-
fullName: string
-
id: string
(uuid)
-
isDispensed(required): boolean
-
shortName(required): string
-
studyVersion(required): string
-
title(required): string
-
visitSeq: integer
(int32)
500 Response
Error
Nested Schema : details
Type:
object