1. REST API for Clinical One Platform
  2. Tasks
  3. Data Capture
  4. Lab
  5. Update lab normals for a subject

V1.0

put

/ec-dc-svc/rest/v1.0/studies/{studyId}/{mode}/labnormals

Updates lab normals for a subject for a particular visit and particular form.

Request

Path Parameters
Supported Media Types
Request Body - application/json ()
Root Schema : schema
Type: object
Show Source
  • Comment
    Example: Updated based on lab report 2023-02-10
  • Unique identifier(UUID, 32-character uppercase hexadecimal string) representing the clinical event like Screening, Visit 1 etc.
    Example: 799EF3745FC545589F186D2198F3C65E
  • Numeric value representing the instance number of the event. Used for repeated or unscheduled visits. It is null for scheduled events.
    Example: 1
  • Unique identifier(UUID, 32-character uppercase hexadecimal string) representing the clinical form.
    Example: 899EF3745FC545589F186D2198F3C65E
  • Unique identifier (UUID, 32-character uppercase hexadecimal string) of the lab normals record. Include for update requests; omit for new create.
    Example: 999EF3745FC545589F186D2198F3C65E
  • Indicates the repeat sequence number of the primary or outer repeating form. This value identifies each top-level occurrence of a repeating form and serves as the parent context for any nested inner repeats.
    Example: 1
  • Reason
    Example: Correction due to re-measurement
  • Unique identifier (UUID, 32-character uppercase hexadecimal string) representing the clinical site.
    Example: 699EF3745FC545589F186D2198F3C65E
  • String representing the version of the study configuration or protocol. Helps track changes in form or study design.
    Example: 1.0.0.3
  • Unique subject identifier (UUID, 32-character uppercase hexadecimal string) representing the patient/participant enrolled in the study.
    Example: A1B2C3D4E5F6471890ABCDEF12345678
Examples

Back to Top

Response

Supported Media Types

200 Response

Success
Body ()
Root Schema : LabResponseDTO
Type: object
Service-level response containing lab normals processing status and data elements with targets and lab properties.
Show Source
  • items
    List of data elements along with targets and associated cleared lab properties
  • labnormalsStatus
    List of lab normals processing status codes resulting from validation and mapping.The value of status can be -DOB_MISSING, GENDER_MISSING, RACE_MISSING, DOB_NO_VALUE_CAPTURED, GENDER_NO_VALUE_CAPTURED, RACE_NO_VALUE_CAPTURED,DOB_INVALID_VALUE, MISSING_CODE_LABEL_FOR_UNIT, MISSING_CODE_LABEL_FOR_NORMAL_TEXT
Nested Schema : items
Type: array
List of data elements along with targets and associated cleared lab properties
Show Source
Nested Schema : labnormalsStatus
Type: array
List of lab normals processing status codes resulting from validation and mapping.The value of status can be -DOB_MISSING, GENDER_MISSING, RACE_MISSING, DOB_NO_VALUE_CAPTURED, GENDER_NO_VALUE_CAPTURED, RACE_NO_VALUE_CAPTURED,DOB_INVALID_VALUE, MISSING_CODE_LABEL_FOR_UNIT, MISSING_CODE_LABEL_FOR_NORMAL_TEXT
Show Source
  • List of lab normals processing status codes resulting from validation and mapping.The value of status can be -DOB_MISSING, GENDER_MISSING, RACE_MISSING, DOB_NO_VALUE_CAPTURED, GENDER_NO_VALUE_CAPTURED, RACE_NO_VALUE_CAPTURED,DOB_INVALID_VALUE, MISSING_CODE_LABEL_FOR_UNIT, MISSING_CODE_LABEL_FOR_NORMAL_TEXT
    Example: ["GENDER_MISSING"]
Example:
[
    "GENDER_MISSING"
]
Nested Schema : DataElementWithTargets
Type: object
Wrapper combining a DataElement with its display targets and related lab properties.
Show Source
Nested Schema : DataElement
Type: object
Represents a data element as captured/stored for a subject during a study, including repeat and validation info.
Show Source
  • Minimum Length: 0
    Maximum Length: 2048
    Comment regarding the last change made to the entity.
    Example: Imported via migration tool.
  • Event occurs when a form is restored.
    Example: FORM_RESTORED
  • Unique Data flag identifier(UUID, 32-character uppercase hexadecimal string).
    Example: C9E86AF896F04FBB82FB755666DA6B58
  • data flag applied, values which are applicable Not Done, Not Applicable, Unknown
    Example: Not Done
  • Unique identifier of the associated source document (hex UUID, 32-character uppercase), enabling traceability between the data element and its original supporting document or file.
    Example: 26C7C2DF6B2546E6BBA8331738FACD1E
  • Unique identifier(UUID, 32-character uppercase hexadecimal string) representing the clinical event like Screening, Visit 1 etc.
    Example: BEEFAABBCCDDEEDDFF00112233445566
  • Numeric value representing the instance number of the event. Used for repeated or unscheduled visits. It is null for scheduled events.
    Example: 3
  • Unique identifier(UUID, 32-character uppercase hexadecimal string) representing the clinical form.
    Example: 360E6122F84A43CAAF70E3BECC471A7C
  • ID (UUID, 32-character uppercase hexadecimal string) of the form section.
    Example: 4FB2D38F8F9644D2B3BE08B815A8FF1A
  • Frozen status of the record can have values NOT_APPLICABLE, FROZEN.
    Example: FROZEN
  • Unique Identfier (UUID, 32-character uppercase hexadecimal string) HDI value for integrations.
    Example: D3C9A4B5E6F78123456789ABCDEF1234
  • Unique identifier(UUID, 32-character uppercase hexadecimal string) for the data element.
    Example: B58C5C21BFC94E1384D0F4C6BA7566F3
  • Indicates the repeat sequence number of a nested or inner repeating form within an outer repeating structure. This value is used to distinguish multiple occurrences of the same inner form for a given outer repeat instance.
    Example: 1
  • Indicates if this safety field is default-selected.
    Example: true
  • Indicates if this triggers a safety-related workflow.
    Example: false
  • Minimum Length: 0
    Maximum Length: 4000
    The formatted value that matches the data type of the question, such as a date in a specific format or a number with correct decimal places. If the user didn't provide a valid response, ItemF will be null.
    Example: example free-field
  • Minimum Length: 0
    Maximum Length: 4000
    Unique Item identifier (UUID, 32-character uppercase hexadecimal string) from the study Designer, associated to a form.
    Example: 7978B7DD0A0A4CA899C485990994300C
  • Minimum Length: 0
    Maximum Length: 4000
    The raw value entered by the user, which can be a text, number, or date, and is stored as alphanumeric data. It may also contain special flags such as NA (Not Applicable), ND (Not Done), UNK (Unknown), or Not Answered if the user didn't provide a response.
    Example: example result_R
  • Minimum Length: 0
    Maximum Length: 255
    Type/category of the item.
    Example: NUMERIC
  • Date/time when lock was applied.
    Example: 2025-05-20T10:30:00Z
  • Indicates if the field is locked.values applicable LOCKED, NEVER_LOCKED, UNLOCKED, NOT_APPLICABLE
    Example: LOCKED
  • Minimum Length: 0
    Maximum Length: 64
    Unit of measurement for value field (e.g. mg, cm).
    Example: mg
  • Minimum Length: 1
    Maximum Length: 16
    Operation type on the record, can have values CREATED, MODIFIED or REMOVED
    Example: REMOVED
  • An identifier representing the system, or user that initiated the transaction (UUID, 32-character uppercase hexadecimal string).
    Example: D340A21830F6465C8466A2B42EF370D5
  • Indicates the repeat sequence number of the primary or outer repeating form. This value identifies each top-level occurrence of a repeating form and serves as the parent context for any nested inner repeats.
    Example: 1
  • Unique Identfier (UUID, 32-character uppercase hexadecimal string) of data capture properties
    Example: FFBC9E118C4C48FDB77A50A1CDD28AA9
  • Start time (timestamp) for the property version.
    Example: 2025-01-01T13:10:00Z
  • Minimum Length: 0
    Maximum Length: 255
    Reason for the entity creation or latest modification.
    Example: Initial import.
  • Form repeat number if applicable.
    Example: 0
  • Indicates the order of occurrence for a repeating form instance, used to distinguish between multiple repetitions of the same form.
    Example: 1
  • Signed status for workflow, the acceptable values are: NEVER_SIGNED, SIGNED, UNSIGNED, NEVER_SIGNED.
    Example: SIGNED
  • Unique identifier (UUID, 32-character uppercase hexadecimal string) representing the clinical site.
    Example: BEEFAABBCCDDEEDDFF00112233445566
  • Minimum Length: 0
    Maximum Length: 100
    Name of the study.
    Example: Study Alpha
  • Minimum Length: 0
    Maximum Length: 100
    String representing the version of the study configuration or protocol. Helps track changes in form or study design.
    Example: 1.0.0.0
  • Unique subject identifier (UUID, 32-character uppercase hexadecimal string) representing the patient/participant enrolled in the study.
    Example: ABD123EFC6784123BBAA1122CCDDEE44
  • Date when the transaction for this element ended.
    Example: 2023-01-21
  • Date when the transaction for this element started.
    Example: 2023-01-20
  • validationRules
    Validation rules applied to this data element.
  • Minimum Length: 0
    Maximum Length: 4000
    Raw string value for the data element (as entered/captured).
    Example: 102.1
  • Variable identifier (UUID, 32-character uppercase hexadecimal string) in uppercase hex format.
    Example: E8EB947A8B684C8B8A30C6070A65BD76
  • Minimum Length: 0
    Maximum Length: 100
    Third-party system or vendor code, if imported.
    Example: VENDOR1
  • Verified status for review workflow,the acceptable values are: NEVER_VEIFIED, VERIFIED, UNVERIFIED, NOT_APPLICABLE.
    Example: VERIFIED
  • Date when the visit started.
    Example: 2025-05-19
  • Allowed Values: [ "NEW", "COMPLETE", "COMPLETE_ERR", "INPROGRESS", "INCOMPLETE", "INCOMPLETE_ERR", "SKIPPED", "UNDO_SKIP", "NOT_STARTED" ]
    Visit status for this data element.
    Example: INPROGRESS
Nested Schema : labs
Type: array
List of cleared laboratory property details related to the data element
Show Source
Nested Schema : targets
Type: array
List of display or rule targets associated with this data element
Show Source
  • List of display or rule targets associated with this data element
    Example: ["93CC828113AC439181071CB44D2C6FE5.93CC828113AC439181071CB44D2C6FE5","93CC828113AC439181071CB44D2C6FE5.93CC828113AC439181071CB44D2C6FE7"]
Example:
[
    "93CC828113AC439181071CB44D2C6FE5.93CC828113AC439181071CB44D2C6FE5",
    "93CC828113AC439181071CB44D2C6FE5.93CC828113AC439181071CB44D2C6FE7"
]
Nested Schema : validationRules
Type: array
Validation rules applied to this data element.
Show Source
Nested Schema : ValidationRuleDto
Type: object
Validation rule details associated with a specific data element.
Show Source
  • Query identifier (UUID, 32-character uppercase hexadecimal string) generated by the validation rule.
    Example: 45B982CDC4604AF5A354AAAF7BEEB93B
  • Status of the query associated with this rule and values can be Candidate, Answered, Closed, Opened, Deleted
    Example: Opened
  • Unique Identifier (UUID, 32-character uppercase hexadecimal string) for the validation rule.
    Example: 45B982CDC4604AF5A354AAAF7BEEB93B
Nested Schema : DCPropertyDto
Type: object
Laboratory property details associated with a data element.
Show Source
  • Comment
    Example: Cleared due to verified lab correction
  • Unique identifier (UUID, 32-character uppercase hexadecimal string) representing the record
    Example: 1BC29B36F5D64B1B95F4BDBBCEA481BE
  • Unique identifier (UUID, 32-character uppercase hexadecimal string) of the lab normals record. Include for update requests; omit for new create.
    Example: 40DB4EF4847849CCB24EFCCB71CDA436
  • Indicates the repeat sequence number of the primary or outer repeating form. This value identifies each top-level occurrence of a repeating form and serves as the parent context for any nested inner repeats.
    Example: 1
  • Reason
    Example: Data cleared by monitor
Examples

400 Response

Bad request.
Body ()
Root Schema : DcsResponse
Type: object
Show Source
Nested 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
    Detailed error context or debugging information such as validation error, stack trace, or field/parameter cause.
  • Application or business-specific error code representing the error type.
    Example: REPT_401
  • Human-readable error message describing the failure or issue.
    Example: Unauthorized: User does not have access to the requested resource
Nested Schema : result
Type: object
Nested Schema : details
Type: object
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
Back to Top