Jump to

• Request
• Response

[Deprecated]: V3.0

get

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

Deprecated: Use latest version instead. Retrieves kit descriptions from non-draft study versions selected by mode. Optional kitType and unblinded query parameters control which kit categories and unblinded kit fields are returned. The response includes kit identifiers, kit type, description, distribution setting, device details, supply type, titration flag, pooling, and serialization details when available.

Request

Path Parameters

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

  Example:

  F054C951EB74443C93716CA714AB686E

Query Parameters

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

  Allowed Values: [ "test", "training", "active" ]

  Example:

  test

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 KitDescDto V3.0
  Title: KitDescDto V3.0

  Kit description and distribution setting

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

Nested Schema : KitDescDto V3.0

Type: object

Title: KitDescDto V3.0

Kit description and distribution setting

Show Source

• deviceConn: string
  Device Connection

  Example: D2C
• deviceType: string
  Device Type

  Example: SCALE
• distributionSetting: string (string)
  Distribution Setting

  Example: UNBLINDED
• kitDescription: string (string)
  Kit description

  Example: Kit_1003_1
• kitId: string (uuid)
  Kit Unique GUID
• kitType: string (string)
  Kit Type ID

  Example: Kit_1003_1
• trialSupplyType: string
  Trial Supply Type

  Example: BOTTLE

{
    "title":"KitDescDto V3.0",
    "type":"object",
    "properties":{
        "kitId":{
            "type":"string",
            "description":"Kit Unique GUID",
            "format":"uuid"
        },
        "kitType":{
            "type":"string",
            "description":"Kit Type ID",
            "format":"string",
            "example":"Kit_1003_1"
        },
        "kitDescription":{
            "type":"string",
            "description":"Kit description",
            "format":"string",
            "example":"Kit_1003_1"
        },
        "distributionSetting":{
            "type":"string",
            "description":"Distribution Setting",
            "format":"string",
            "example":"UNBLINDED"
        },
        "deviceType":{
            "type":"string",
            "description":"Device Type",
            "example":"SCALE"
        },
        "deviceConn":{
            "type":"string",
            "description":"Device Connection",
            "example":"D2C"
        },
        "trialSupplyType":{
            "type":"string",
            "description":"Trial Supply Type",
            "example":"BOTTLE"
        }
    },
    "description":"Kit description and distribution setting"
}

Examples

Select an example successResponse

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

Title: ErrorResponseData

Error Response Details Information

Show Source

• details: object Object
  Title: Object

  Object with error details information.
• errorCode: string
  Error code which is stored in ErrorCode enum. Example : C1-003

  Example: C1-003
• errorMessage: string
  Error message which is stored in service property file. Example : Cannot modify object after a study version has been approved

  Example: Cannot modify object after a study version has been approved

{
    "title":"ErrorResponseData",
    "type":"object",
    "properties":{
        "errorCode":{
            "type":"string",
            "description":"Error code which is stored in ErrorCode enum. Example : C1-003",
            "example":"C1-003"
        },
        "errorMessage":{
            "type":"string",
            "description":"Error message which is stored in service property file. Example : Cannot modify object after a study version has been approved",
            "example":"Cannot modify object after a study version has been approved"
        },
        "details":{
            "title":"Object",
            "type":"object",
            "description":"Object with error details information.",
            "example":{
                "field":"studyId",
                "reason":"Invalid value"
            }
        }
    },
    "description":"Error Response Details Information"
}

Nested Schema : Object

Type: object

Title: Object

Object with error details information.

Example:

{
    "field":"studyId",
    "reason":"Invalid value"
}

Back to Top