Jump to

• Request
• Response

V2.0

get

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

Retrieves all statuses summary for a specified study ID.

Request

Path Parameters

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

  Example:

  2F9A6C7E1B8F4D56A23C9F3A0C7D4E11

Query Parameters

• versionStatus: string
  Study status filter. Allowed values: DRAFT (editable work-in-progress), TESTING (validation phase), APPROVED (production-ready), ARCHIVED (historical copy). Optional.

  Default Value:

  Example:

  draft

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

  Summary information about a study

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

Nested Schema : StudyStatusSummaryDto v2.0

Type: object

Title: StudyStatusSummaryDto v2.0

Summary information about a study

Show Source

• id: string (uuid)
  Study Unique GUID
• lastModified: string
• sourceStudyId: string (uuid)
  Study Unique GUID
• sourceStudyTitle: string (string)
  Source study title

  Example: The study
• sourceStudyVersion: string (string)
  Source study version

  Example: 1.0.0.1
• studyDescription: string
  Study description or protocol title

  Example: A randomized double blind placebo controlled study to investigate the safety of microphylla in healthy adult volunteers.
• studyState: string
  Allowed Values: [ "settings, active, design, test, training" ]

  Current study state
• studyStatus: string
  Allowed Values: [ "DRAFT", "TESTING", "APPROVED", "ARCHIVED" ]

  Current study status

  Example: APPROVED
• studyTitle: string
  Study Title or protocol number

  Example: TICIPS001
• version: string
  Study version

  Example: 1.0.0.3
• versionStart: string (date-time)
  Version Start date
• versionStatus: string
  Study version status

  Example: Active, not recruiting
• versionTitle: string
  Study Title or protocol number

  Example: TICIPS001:1.0.0.3

{
    "title":"StudyStatusSummaryDto v2.0",
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"Study Unique GUID",
            "format":"uuid"
        },
        "version":{
            "type":"string",
            "description":"Study version",
            "example":"1.0.0.3"
        },
        "studyTitle":{
            "type":"string",
            "description":"Study Title or protocol number",
            "example":"TICIPS001"
        },
        "studyDescription":{
            "type":"string",
            "description":"Study description or protocol title",
            "example":"A randomized double blind placebo controlled study to investigate the safety of microphylla in healthy adult volunteers."
        },
        "versionTitle":{
            "type":"string",
            "description":"Study Title or protocol number",
            "example":"TICIPS001:1.0.0.3"
        },
        "versionStart":{
            "type":"string",
            "description":"Version Start date",
            "format":"date-time"
        },
        "lastModified":{
            "type":"string"
        },
        "versionStatus":{
            "type":"string",
            "description":"Study version status",
            "example":"Active, not recruiting"
        },
        "studyStatus":{
            "type":"string",
            "description":"Current study status",
            "example":"APPROVED",
            "enum":[
                "DRAFT",
                "TESTING",
                "APPROVED",
                "ARCHIVED"
            ]
        },
        "studyState":{
            "type":"string",
            "description":"Current study state",
            "enum":[
                "settings, active, design, test, training"
            ]
        },
        "sourceStudyId":{
            "type":"string",
            "description":"Study Unique GUID",
            "format":"uuid"
        },
        "sourceStudyVersion":{
            "type":"string",
            "description":"Source study version",
            "format":"string",
            "example":"1.0.0.1"
        },
        "sourceStudyTitle":{
            "type":"string",
            "description":"Source study title",
            "format":"string",
            "example":"The study"
        }
    },
    "description":"Summary information about a study"
}

Examples

Select an example successResponse

404 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

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