1. REST API for Clinical One Platform
  2. Tasks
  3. Data Actions
  4. Data Elements
  5. Get data elements items summary for locked or frozen

V1.0

post

/ec-dataaction-svc/rest/v1.0/studies/{studyId}/{mode}/validate/multipleitems

Provides the summary for the list of the data elements and returns the actions of the item like frozen or locked.

Request

Path Parameters
Supported Media Types
Request Body - application/json ()
Root Schema : schema
Type: object
Request DTO with a list of DataElement objects for multifield data validation.
Show Source
Nested Schema : dataElements
Type: array
The list of data elements to validate.
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 : 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
Examples

Back to Top

Response

Supported Media Types

200 Response

Validation completed, returns list of validation details for each submitted data element.
Body ()
Root Schema : DataElementValidationDto
Type: object
Representing validation result/status for a specific data element instance, including lock and repeat status information.
Show Source
  • Unique identifier(UUID, 32-character uppercase hexadecimal string) representing the clinical event like Screening, Visit 1 etc.
    Example: 9A201C440D40426080C825762206D64B
  • Numeric value representing the instance number of the event. Used for repeated or unscheduled visits. It is null for scheduled events.
    Example: 2
  • Unique identifier(UUID, 32-character uppercase hexadecimal string) representing the clinical form.
    Example: 12197E724A1C47C8A740153E5948AB19
  • Unique identifier(UUID, 32-character uppercase hexadecimal string) of the data element given in format of UUID.
    Example: 64C57ED1076F47078C8E5AD537244989
  • 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
  • Whether the item is frozen for this record.
    Example: true
  • Whether the item is locked for this record.
    Example: true
  • Whether the parent is locked for this record.
    Example: false
  • Whether the subject is locked for this record.
    Example: false
  • Unique Item identifier (UUID, 32-character uppercase hexadecimal string) from the study Designer, associated to a form.
    Example: F7F805CA51B545BFB5808EF7952ED597
  • 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
  • Form repeat number if applicable.
    Example: 1
  • Indicates the order of occurrence for a repeating form instance, used to distinguish between multiple repetitions of the same form.
    Example: 1
  • Unique subject identifier (UUID, 32-character uppercase hexadecimal string) representing the patient/participant enrolled in the study.
    Example: C5E90E4184BC4205978759A808245E98
Examples

400 Response

Bad request.
Body ()
Root Schema : RestResponse
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