• Array of: object KitDto v3.0
  Title: KitDto v3.0

  Kit details.

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

• dosage: number (double)
  Dosage.

  Example: 50
• dosings: array dosings
• id: string (uuid)
• isDefault: boolean
  Is kit default.

  Example: true
• kitid: string (uuid)
  Kit GUID
• kitSettings: object KitSettingsDto v3.0
  Title: KitSettingsDto v3.0

  Contains settings information on the kit.
• kitTitrations: array kitTitrations
• kitUnitSettings: object KitUnitSettingsDto v3.0
  Title: KitUnitSettingsDto v3.0

  Contains unit settings information on the kit.
• studyId: string (uuid)
  Study GUID
• studyVersionEnd: string (date-time)
  Study version end
• studyVersionStart: string (date-time)
  Study version start
• versionEnd: string (date-time)
  Version End
• versionStart: string (date-time)
  Version Start

{
    "title":"KitDto v3.0",
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "format":"uuid"
        },
        "kitid":{
            "type":"string",
            "description":"Kit GUID",
            "format":"uuid"
        },
        "kitSettings":{
            "$ref":"#/components/schemas/KitSettingsDtoV3"
        },
        "kitUnitSettings":{
            "$ref":"#/components/schemas/KitUnitSettingsDtoV3"
        },
        "kitTitrations":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/KitTitrationsDtoV3"
            }
        },
        "dosings":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/KitDosingDtoV3"
            }
        },
        "dosage":{
            "type":"number",
            "description":"Dosage.",
            "format":"double",
            "example":50
        },
        "isDefault":{
            "type":"boolean",
            "description":"Is kit default.",
            "example":true
        },
        "versionStart":{
            "type":"string",
            "description":"Version Start",
            "format":"date-time"
        },
        "versionEnd":{
            "type":"string",
            "description":"Version End",
            "format":"date-time"
        },
        "studyId":{
            "type":"string",
            "description":"Study GUID",
            "format":"uuid"
        },
        "studyVersionStart":{
            "type":"string",
            "description":"Study version start",
            "format":"date-time"
        },
        "studyVersionEnd":{
            "type":"string",
            "description":"Study version end",
            "format":"date-time"
        }
    },
    "description":"Kit details."
}

• Array of: object KitDosingDto v3.0
  Title: KitDosingDto v3.0

  Information on a calculated dose.

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

• bufferdays: integer (int64)
  The number of buffer days

  Example: 5
• calculatingDoses: boolean
  Indicates if the kit has calculating doses

  Example: true
• dispenseOnHighestDose: boolean
  Indicates if dispensation should happen on up titrate when already on highest dose

  Example: true
• dispenseOnHighestDoseMsg: string
  Message to user on up titrate when subject is on highest dose

  Example: Message when subject is on highest dose
• dispenseOnLowestDose: boolean
  Indicates if dispensation should happen on down titrate when already on lowest dose

  Example: true
• dispenseOnLowestDoseMsg: string
  Message to user on down titrate when subject is on lowest dose

  Example: Message when subject is on lowest dose
• dispenseOutsideWindow: boolean
  Indicates if the kit may be dispensed outside the window

  Example: false
• distributionSetting: string
  Indicates if the kit blinded or unblinded

  Example: BLINDED
• doseChangeUnschVisit: boolean
  Indicates if dosage change is allowed in an unscheduled visit for the titration kit

  Example: false
• dosingFrequency: boolean
  Indicates if the titration kit has dosing frequencies defined

  Example: true
• downTitrateDose: integer (int64)
  The maximum number of down titrate dosage change allowed for the titration kit

  Example: 2
• downTitrateDoseUnscheduled: integer (int64)
  The maximum number of down titrate dosage change allowed for the titration kit for unscheduled visits

  Example: 2
• kitDescription: string
  The kit description

  Example: ORS-123(IP 0.01%)
• kitTypeId: string
  The kit type id

  Example: Type
• maxDoseChanges: integer (int64)
  The maximum number of dosage changes allowed for the titration kit

  Example: 3
• minShipUnits: integer (int64)
  The minimum kit to ship

  Example: 10
• storageSetting: string
  The storage temperature

  Example: AMBIENT
• timeBetweenDownDoseChanges: integer (int64)
  Time between down dosage changes

  Example: 20
• timeBetweenDownDoseChangesUnit: string
  Unit for time between down dosage changes

  Example: DAYS
• timeBetweenUpDoseChanges: integer (int64)
  Time between up dosage changes

  Example: 20
• timeBetweenUpDoseChangesUnit: string
  Unit for time between up dosage changes

  Example: DAYS
• titratingDoses: boolean
  Indicates if the kit has titrating doses

  Example: true
• titrationKit: boolean
  Indicates if the kit is a titration kit

  Example: true
• totalDoseUnscheduled: integer (int64)
  The maximum number of dosage changes allowed for the titration kit for unscheduled visits

  Example: 3
• trialSupplyType: string
  The kit type

  Example: BOTTLE
• upTitrateDose: integer (int64)
  The maximum number of up titrate dosage change allowed for the titration kit

  Example: 1
• upTitrateDoseUnscheduled: integer (int64)
  The maximum number of up titrate dosage change allowed for the titration kit for unscheduled visits

  Example: 1

{
    "title":"KitSettingsDto v3.0",
    "type":"object",
    "properties":{
        "calculatingDoses":{
            "type":"boolean",
            "description":"Indicates if the kit has calculating doses",
            "example":true
        },
        "titratingDoses":{
            "type":"boolean",
            "description":"Indicates if the kit has titrating doses",
            "example":true
        },
        "titrationKit":{
            "type":"boolean",
            "description":"Indicates if the kit is a titration kit",
            "example":true
        },
        "distributionSetting":{
            "type":"string",
            "description":"Indicates if the kit blinded or unblinded",
            "example":"BLINDED"
        },
        "kitTypeId":{
            "type":"string",
            "description":"The kit type id",
            "example":"Type"
        },
        "kitDescription":{
            "type":"string",
            "description":"The kit description",
            "example":"ORS-123(IP 0.01%)"
        },
        "storageSetting":{
            "type":"string",
            "description":"The storage temperature",
            "example":"AMBIENT"
        },
        "trialSupplyType":{
            "type":"string",
            "description":"The kit type",
            "example":"BOTTLE"
        },
        "minShipUnits":{
            "type":"integer",
            "description":"The minimum kit to ship",
            "format":"int64",
            "example":10
        },
        "bufferdays":{
            "type":"integer",
            "description":"The number of buffer days",
            "format":"int64",
            "example":5
        },
        "dispenseOutsideWindow":{
            "type":"boolean",
            "description":"Indicates if the kit may be dispensed outside the window",
            "example":false
        },
        "dosingFrequency":{
            "type":"boolean",
            "description":"Indicates if the titration kit has dosing frequencies defined",
            "example":true
        },
        "doseChangeUnschVisit":{
            "type":"boolean",
            "description":"Indicates if dosage change is allowed in an unscheduled visit for the titration kit",
            "example":false
        },
        "maxDoseChanges":{
            "type":"integer",
            "description":"The maximum number of dosage changes allowed for the titration kit",
            "format":"int64",
            "example":3
        },
        "upTitrateDose":{
            "type":"integer",
            "description":"The maximum number of up titrate dosage change allowed for the titration kit",
            "format":"int64",
            "example":1
        },
        "downTitrateDose":{
            "type":"integer",
            "description":"The maximum number of down titrate dosage change allowed for the titration kit",
            "format":"int64",
            "example":2
        },
        "totalDoseUnscheduled":{
            "type":"integer",
            "description":"The maximum number of dosage changes allowed for the titration kit for unscheduled visits",
            "format":"int64",
            "example":3
        },
        "upTitrateDoseUnscheduled":{
            "type":"integer",
            "description":"The maximum number of up titrate dosage change allowed for the titration kit for unscheduled visits",
            "format":"int64",
            "example":1
        },
        "downTitrateDoseUnscheduled":{
            "type":"integer",
            "description":"The maximum number of down titrate dosage change allowed for the titration kit for unscheduled visits",
            "format":"int64",
            "example":2
        },
        "timeBetweenUpDoseChangesUnit":{
            "type":"string",
            "description":"Unit for time between up dosage changes",
            "example":"DAYS"
        },
        "timeBetweenUpDoseChanges":{
            "type":"integer",
            "description":"Time between up dosage changes",
            "format":"int64",
            "example":20
        },
        "timeBetweenDownDoseChangesUnit":{
            "type":"string",
            "description":"Unit for time between down dosage changes",
            "example":"DAYS"
        },
        "timeBetweenDownDoseChanges":{
            "type":"integer",
            "description":"Time between down dosage changes",
            "format":"int64",
            "example":20
        },
        "dispenseOnHighestDose":{
            "type":"boolean",
            "description":"Indicates if dispensation should happen on up titrate when already on highest dose",
            "example":true
        },
        "dispenseOnLowestDose":{
            "type":"boolean",
            "description":"Indicates if dispensation should happen on down titrate when already on lowest dose",
            "example":true
        },
        "dispenseOnHighestDoseMsg":{
            "type":"string",
            "description":"Message to user on up titrate when subject is on highest dose",
            "example":"Message when subject is on highest dose"
        },
        "dispenseOnLowestDoseMsg":{
            "type":"string",
            "description":"Message to user on down titrate when subject is on lowest dose",
            "example":"Message when subject is on lowest dose"
        }
    },
    "description":"Contains settings information on the kit."
}

• Array of: object KitTitrationsDto v3.0
  Title: KitTitrationsDto v3.0

  Contains titrations information on the titration kit.

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

• singleUnitDose: object KitDosingValueUnitsDto v3.0
  Title: KitDosingValueUnitsDto v3.0

  Describes the value/unit pair of the measurement on the calculated dose.
• unitsPerKit: number (double)
  The number of units per kit

  Example: 20

{
    "title":"KitUnitSettingsDto v3.0",
    "type":"object",
    "properties":{
        "unitsPerKit":{
            "type":"number",
            "description":"The number of units per kit",
            "format":"double",
            "example":20
        },
        "singleUnitDose":{
            "$ref":"#/components/schemas/KitDosingValueUnitsDtoV3"
        }
    },
    "description":"Contains unit settings information on the kit."
}

• dose: object KitDosingDoseDto v3.0
  Title: KitDosingDoseDto v3.0

  Dose information on the calculated dose.
• id: string (uuid)
  Dosing GUID
• measurement: object KitDosingMeasurementDto v3.0
  Title: KitDosingMeasurementDto v3.0

  Kit and subject measurement information on a calculated dose.
• name: string
  Dosing display name

  Example: Name
• question: object KitDosingQuestionDto v3.0
  Title: KitDosingQuestionDto v3.0

  Form and question information on the calculated dose.
• visit: object KitDosingVisitDto v3.0
  Title: KitDosingVisitDto v3.0

  Visit information on the calculated dose.

{
    "title":"KitDosingDto v3.0",
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"Dosing GUID",
            "format":"uuid"
        },
        "name":{
            "type":"string",
            "description":"Dosing display name",
            "example":"Name"
        },
        "question":{
            "$ref":"#/components/schemas/KitDosingQuestionDtoV3"
        },
        "visit":{
            "$ref":"#/components/schemas/KitDosingVisitDtoV3"
        },
        "dose":{
            "$ref":"#/components/schemas/KitDosingDoseDtoV3"
        },
        "measurement":{
            "$ref":"#/components/schemas/KitDosingMeasurementDtoV3"
        }
    },
    "description":"Information on a calculated dose."
}

• frequency: string
  Dosing frequency

  Example: Before bedtime
• leftOverUnits: boolean
  Use leftover units in next dose

  Example: true
• precision: integer (int32)
  Precision for each dose

  Example: 1
• roundUp: integer (int32)
  Rounded up for dosing calculation

  Example: 1

{
    "title":"KitDosingDoseDto v3.0",
    "type":"object",
    "properties":{
        "precision":{
            "type":"integer",
            "description":"Precision for each dose",
            "format":"int32",
            "example":1
        },
        "roundUp":{
            "type":"integer",
            "description":"Rounded up for dosing calculation",
            "format":"int32",
            "example":1
        },
        "frequency":{
            "type":"string",
            "description":"Dosing frequency",
            "example":"Before bedtime"
        },
        "leftOverUnits":{
            "type":"boolean",
            "description":"Use leftover units in next dose",
            "example":true
        }
    },
    "description":"Dose information on the calculated dose."
}

• kit: object KitDosingValueUnitsDto v3.0
  Title: KitDosingValueUnitsDto v3.0

  Describes the value/unit pair of the measurement on the calculated dose.
• subject: object KitDosingValueUnitsDto v3.0
  Title: KitDosingValueUnitsDto v3.0

  Describes the value/unit pair of the measurement on the calculated dose.

{
    "title":"KitDosingMeasurementDto v3.0",
    "type":"object",
    "properties":{
        "kit":{
            "$ref":"#/components/schemas/KitDosingValueUnitsDtoV3"
        },
        "subject":{
            "$ref":"#/components/schemas/KitDosingValueUnitsDtoV3"
        }
    },
    "description":"Kit and subject measurement information on a calculated dose."
}

• formId: string (uuid)
  The form Id
• itemId: string (uuid)
  The question Id

{
    "title":"KitDosingQuestionDto v3.0",
    "type":"object",
    "properties":{
        "formId":{
            "type":"string",
            "description":"The form Id",
            "format":"uuid"
        },
        "itemId":{
            "type":"string",
            "description":"The question Id",
            "format":"uuid"
        }
    },
    "description":"Form and question information on the calculated dose."
}

• id: string (uuid)
  The visit Id
• type: string
  The type of visit, eg. screening, scheduled, or current

  Example: screening

{
    "title":"KitDosingVisitDto v3.0",
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"The visit Id",
            "format":"uuid"
        },
        "type":{
            "type":"string",
            "description":"The type of visit, eg. screening, scheduled, or current",
            "example":"screening"
        }
    },
    "description":"Visit information on the calculated dose."
}

• units: string
  The unit of a measurement

  Example: mg
• value: number (double)
  The value of a measurement

  Example: 50

{
    "title":"KitDosingValueUnitsDto v3.0",
    "type":"object",
    "properties":{
        "value":{
            "type":"number",
            "description":"The value of a measurement",
            "format":"double",
            "example":50
        },
        "units":{
            "type":"string",
            "description":"The unit of a measurement",
            "example":"mg"
        }
    },
    "description":"Describes the value/unit pair of the measurement on the calculated dose."
}

• downTitrationKitJson: object TitrationKitItemsDto v3.0
  Title: TitrationKitItemsDto v3.0

  Titration Kit Items
• rowId: string (uuid)
  Id of the titration row
• titrationKitId: string (uuid)
  Id of the current titration kit
• titrationKitJson: object TitrationKitItemsDto v3.0
  Title: TitrationKitItemsDto v3.0

  Titration Kit Items
• titrationKitSeq: integer (int64)
  Sequence number of the current titration row within the kit

  Example: 5
• upTitrationKitJson: object TitrationKitItemsDto v3.0
  Title: TitrationKitItemsDto v3.0

  Titration Kit Items

{
    "title":"KitTitrationsDto v3.0",
    "type":"object",
    "properties":{
        "rowId":{
            "type":"string",
            "description":"Id of the titration row",
            "format":"uuid"
        },
        "titrationKitId":{
            "type":"string",
            "description":"Id of the current titration kit",
            "format":"uuid"
        },
        "titrationKitSeq":{
            "type":"integer",
            "description":"Sequence number of the current titration row within the kit",
            "format":"int64",
            "example":5
        },
        "titrationKitJson":{
            "$ref":"#/components/schemas/TitrationKitItemsDtoV3"
        },
        "upTitrationKitJson":{
            "$ref":"#/components/schemas/TitrationKitItemsDtoV3"
        },
        "downTitrationKitJson":{
            "$ref":"#/components/schemas/TitrationKitItemsDtoV3"
        }
    },
    "description":"Contains titrations information on the titration kit."
}

• titrationKitItems: array titrationKitItems

{
    "title":"TitrationKitItemsDto v3.0",
    "type":"object",
    "properties":{
        "titrationKitItems":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/TitrationKitItemDtoV3"
            }
        }
    },
    "description":"Titration Kit Items"
}

• Array of: object TitrationKitItemDto v3.0
  Title: TitrationKitItemDto v3.0

  Titration Kit Item

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

• kitDosage: string
  Kit Dosage

  Example: QD
• kitid: string (uuid)
  Kit GUID
• kitSeq: integer (int64)
  Kit Sequence

  Example: 1

{
    "title":"TitrationKitItemDto v3.0",
    "type":"object",
    "properties":{
        "kitid":{
            "type":"string",
            "description":"Kit GUID",
            "format":"uuid"
        },
        "kitSeq":{
            "type":"integer",
            "description":"Kit Sequence",
            "format":"int64",
            "example":1
        },
        "kitDosage":{
            "type":"string",
            "description":"Kit Dosage",
            "example":"QD"
        }
    },
    "description":"Titration Kit Item"
}

• 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."
}