REST API for Clinical One Platform

Get all active factors in a study

get

/ec-designer-ors-svc/rest/v3.0/studies/{studyId}/randomizationfactors

Retrieves a list of Study factors. You can retrieve this list by study mode and RandType.

Request

Path Parameters

studyId(required): string(uuid)

Query Parameters

mode(required): string

Study version mode to filter factors.

Allowed Values: [ "test", "training", "active" ]
type(required): string

Rand Algorithim to filter factors.

Default Value: ALL

Allowed Values: [ "stratum", "cohort", "minimization", "all" ]

There's no request body for this operation.

Response

Supported Media Types

application/json

200 Response

Successful operation.

Root Schema : schema

Type: array

Show Source

Array of: object Randomization Factor Details v3.0

Title: Randomization Factor Details v3.0

Randomization Factors DTO

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

Nested Schema : Randomization Factor Details v3.0

Type: object

Title: Randomization Factor Details v3.0

Randomization Factors DTO

Show Source

details: object RandomizationDetails v5.0

Title: RandomizationDetails v5.0

Details of the randomization design.
groups: object RandomizationFactorGroupDto v3.0

Title: RandomizationFactorGroupDto v3.0

RandomizationFactorGroupDto Info

{
    "title":"Randomization Factor Details v3.0",
    "type":"object",
    "properties":{
        "details":{
            "$ref":"#/components/schemas/RandomizationDetailsV5"
        },
        "groups":{
            "title":"RandomizationFactorGroupDto v3.0",
            "type":"object",
            "properties":{
                "id":{
                    "type":"string",
                    "description":"Stratum or Cohort Unique GUID",
                    "format":"uuid"
                },
                "formTitle":{
                    "type":"string",
                    "description":"formTitle",
                    "example":"Demography"
                },
                "questionTitle":{
                    "type":"string",
                    "description":"questionTitle",
                    "example":"Age"
                },
                "groupName":{
                    "type":"string",
                    "description":"Stratum or Cohort GroupName",
                    "example":"Group Name 1"
                },
                "groupId":{
                    "type":"string",
                    "description":" Rand Stratum Factor Id",
                    "format":"uuid"
                },
                "formCategory":{
                    "type":"string",
                    "description":"Form category",
                    "example":"DCS"
                },
                "formSubcategory":{
                    "type":"string",
                    "description":"List of form subcategories"
                },
                "instructionalText":{
                    "type":"string",
                    "description":"Instructional Text"
                },
                "parentCohortId":{
                    "type":"string",
                    "description":"Parent Cohort Id",
                    "format":"uuid"
                },
                "parentCohortName":{
                    "type":"string",
                    "description":"Name of the Parent Cohort"
                }
            },
            "description":"RandomizationFactorGroupDto Info"
        }
    },
    "description":"Randomization Factors DTO"
}

Nested Schema : RandomizationDetails v5.0

Type: object

Title: RandomizationDetails v5.0

Details of the randomization design.

Show Source

algorithm(required): string

Allowed Values: [ "NONE", "CENTRAL", "CENTRAL_STRATIFIED", "SITE_BLOCKED_FIXED", "SITE_BLOCKED_FIXED_STRATIFIED", "SITE_BLOCKED_DYNAMIC", "SITE_BLOCKED_DYNAMIC_STRATIFIED", "COUNTRY_BLOCKED_FIXED", "COUNTRY_BLOCKED_FIXED_STRATIFIED", "COUNTRY_BLOCKED_DYNAMIC", "COUNTRY_BLOCKED_DYNAMIC_STRATIFIED", "REGION_BLOCKED_FIXED", "REGION_BLOCKED_FIXED_STRATIFIED", "REGION_BLOCKED_DYNAMIC", "REGION_BLOCKED_DYNAMIC_STRATIFIED", "MINIMIZATION" ]

The algorithm of the randomization design

Example: Central
cohortType(required): string

Allowed Values: [ "NoCohort", "Adaptive", "Demography", "invalid" ]

The cohort type of the randomization design

Example: None
description: string

Minimum Length: 0

Maximum Length: 4000

Randomization Design Description

Example: Method to assign study participants to a treatment group.
randomizationType(required): string

Allowed Values: [ "Blinded", "Unblinded", "invalid" ]

Type of the randomization design

Example: Blinded
reRandomization: boolean

Whether to use re-randomization on the randomization design

Example: true
title(required): string

Minimum Length: 1

Maximum Length: 64

Randomization Title

Example: Rand 001
treatmentArms: string

Allowed Values: [ "Randomized", "Mapped", "None", "invalid" ]

Whether to use randomized or mapped on the randomization design

Example: Randomized

{
    "title":"RandomizationDetails v5.0",
    "required":[
        "algorithm",
        "cohortType",
        "randomizationType",
        "title"
    ],
    "type":"object",
    "properties":{
        "title":{
            "maxLength":64,
            "minLength":1,
            "type":"string",
            "description":"Randomization Title",
            "example":"Rand 001"
        },
        "description":{
            "maxLength":4000,
            "minLength":0,
            "type":"string",
            "description":"Randomization Design Description",
            "example":"Method to assign study participants to a treatment group."
        },
        "algorithm":{
            "type":"string",
            "description":"The algorithm of the randomization design",
            "example":"Central",
            "enum":[
                "NONE",
                "CENTRAL",
                "CENTRAL_STRATIFIED",
                "SITE_BLOCKED_FIXED",
                "SITE_BLOCKED_FIXED_STRATIFIED",
                "SITE_BLOCKED_DYNAMIC",
                "SITE_BLOCKED_DYNAMIC_STRATIFIED",
                "COUNTRY_BLOCKED_FIXED",
                "COUNTRY_BLOCKED_FIXED_STRATIFIED",
                "COUNTRY_BLOCKED_DYNAMIC",
                "COUNTRY_BLOCKED_DYNAMIC_STRATIFIED",
                "REGION_BLOCKED_FIXED",
                "REGION_BLOCKED_FIXED_STRATIFIED",
                "REGION_BLOCKED_DYNAMIC",
                "REGION_BLOCKED_DYNAMIC_STRATIFIED",
                "MINIMIZATION"
            ]
        },
        "cohortType":{
            "type":"string",
            "description":"The cohort type of the randomization design",
            "example":"None",
            "enum":[
                "NoCohort",
                "Adaptive",
                "Demography",
                "invalid"
            ]
        },
        "randomizationType":{
            "type":"string",
            "description":"Type of the randomization design",
            "example":"Blinded",
            "enum":[
                "Blinded",
                "Unblinded",
                "invalid"
            ]
        },
        "reRandomization":{
            "type":"boolean",
            "description":"Whether to use re-randomization on the randomization design",
            "example":true
        },
        "treatmentArms":{
            "type":"string",
            "description":"Whether to use randomized or mapped on the randomization design",
            "example":"Randomized",
            "enum":[
                "Randomized",
                "Mapped",
                "None",
                "invalid"
            ]
        }
    },
    "description":"Details of the randomization design."
}

Nested Schema : RandomizationFactorGroupDto v3.0

Type: object

Title: RandomizationFactorGroupDto v3.0

RandomizationFactorGroupDto Info

Show Source

formCategory: string

Form category

Example: DCS
formSubcategory: string

List of form subcategories
formTitle: string

formTitle

Example: Demography
groupId: string (uuid)

Rand Stratum Factor Id
groupName: string

Stratum or Cohort GroupName

Example: Group Name 1
id: string (uuid)

Stratum or Cohort Unique GUID
instructionalText: string

Instructional Text
parentCohortId: string (uuid)

Parent Cohort Id
parentCohortName: string

Name of the Parent Cohort
questionTitle: string

questionTitle

Example: Age

{
    "title":"RandomizationFactorGroupDto v3.0",
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"Stratum or Cohort Unique GUID",
            "format":"uuid"
        },
        "formTitle":{
            "type":"string",
            "description":"formTitle",
            "example":"Demography"
        },
        "questionTitle":{
            "type":"string",
            "description":"questionTitle",
            "example":"Age"
        },
        "groupName":{
            "type":"string",
            "description":"Stratum or Cohort GroupName",
            "example":"Group Name 1"
        },
        "groupId":{
            "type":"string",
            "description":" Rand Stratum Factor Id",
            "format":"uuid"
        },
        "formCategory":{
            "type":"string",
            "description":"Form category",
            "example":"DCS"
        },
        "formSubcategory":{
            "type":"string",
            "description":"List of form subcategories"
        },
        "instructionalText":{
            "type":"string",
            "description":"Instructional Text"
        },
        "parentCohortId":{
            "type":"string",
            "description":"Parent Cohort Id",
            "format":"uuid"
        },
        "parentCohortName":{
            "type":"string",
            "description":"Name of the Parent Cohort"
        }
    },
    "description":"RandomizationFactorGroupDto Info"
}

500 Response

Error

Root Schema : ErrorResponseData

Type: object

Structure representing an error response from the reporting service. Contains an error code, human-readable message, and details.

Show Source

details: string

Detailed error context or debugging information such as validation error, stack trace, or field/parameter cause.

Example: User role is missing required permission REPORTING_VIEW. Field: userId
errorCode: string

Application or business-specific error code representing the error type.

Example: REPT_401
errorMessage: string

Human-readable error message describing the failure or issue.

Example: Unauthorized: User does not have access to the requested resource

{
    "type":"object",
    "properties":{
        "errorCode":{
            "type":"string",
            "description":"Application or business-specific error code representing the error type.",
            "example":"REPT_401"
        },
        "errorMessage":{
            "type":"string",
            "description":"Human-readable error message describing the failure or issue.",
            "example":"Unauthorized: User does not have access to the requested resource"
        },
        "details":{
            "type":"string",
            "description":"Detailed error context or debugging information such as validation error, stack trace, or field/parameter cause.",
            "example":"User role is missing required permission REPORTING_VIEW. Field: userId"
        }
    },
    "description":"Structure representing an error response from the reporting service. Contains an error code, human-readable message, and details."
}