v3.0
get
/ec-query-svc/rest/v3.0/studies/{studyId}/{mode}/queries/queryTable
Compared to v2.0, this v3.0 endpoint exposes the new propertyType, propertyName, and userName columns introduced for assigned query enhancements while maintaining the normalized pagination contract. This benefits users by enabling richer query-table analytics without custom joins.
Request
Path Parameters
-
mode(required): string
Study mode. Allowed values: test (testing sandbox), training (training environment), and active (production).
-
studyId(required): string(uuid)
Clinical One study identifier formatted as a 32 to 36 character GUID.
Query Parameters
-
limit: string
Minimum Length:
1Maximum Length:255LimitExample:value -
offset: string
Minimum Length:
1Maximum Length:255OffsetExample:value -
queryId: string
Minimum Length:
1Maximum Length:255Query ID.Example:value -
sort: string
Minimum Length:
1Maximum Length:255Sort Order: desc-descending order, any other value-ascending order.Default Value:ascExample:value
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
200 Response
Successful operation.
Root Schema : schema
Type:
Show Source
array-
Array of:
object QueryTabDTO Version 3
Title:
QueryTabDTO Version 3Table of query information
Nested Schema : QueryTabDTO Version 3
Type:
objectTitle:
QueryTabDTO Version 3Table of query information
Show Source
-
branchId: string
(uuid)
Branch unique GUID.
-
comment: string
Additional comment about the operation.Example:
site12 -
creatorStudyRoleId: string
(uuid)
Creator study role unique GUID.
-
dataElementId: string
(uuid)
Data element unique GUID.
-
discrepancyId: integer
(int64)
Unique discrepancy identifier. Negative values are rejected.Example:
123456789 -
eventId: string
(uuid)
Event unique GUID.
-
eventInstanceNumber: number
(bigdecimal)
Sequence number (0, 1, 2, ...) of repeating event. Negative values are rejected.Example:
0 -
formId: string
(uuid)
Form unique GUID.
-
formInstanceNumber: number
(bigdecimal)
Sequence number (0, 1, 2, ...) of repeating form. Negative values are rejected.Example:
0 -
id: string
(uuid)
Query Unique GUID.
-
itemId: string
(uuid)
Item unique GUID.
-
objectVersionNumber: number
(bigdecimal)
Sequence number (0, 1, 2, ...) of object version number. Negative values are rejected.Example:
0 -
operationType: string
Allowed Values:
[ "CREATED", "UPDATED", "REMOVED" ]Operation type applied to the record. CREATED = new record inserted; UPDATED = record changed; REMOVED = record deleted or inactivated.Example:CREATED -
propertyName: string
Property Name of QueryExample:
visitStartDate -
propertyType: string
Property Type of QueryExample:
visit -
queryComment: string
Minimum Length:
1Maximum Length:2048Query comments supplied by the responder.Example:Comment -
reason: string
Reason provided for the last operation.Example:
Study roles assignment change -
repeatFormNumber: integer
(int64)
Repeat form number. Negative values are rejected.Example:
0 -
ruleId: string
(uuid)
Rule unique GUID.
-
siteId: string
(uuid)
Site unique GUID.
-
softwareVersionNumber: number
(bigdecimal)
Software version number used when the record was stored. Negative values are rejected.Example:
1 -
state: string
Allowed Values:
[ "Candidate", "Opened", "Answered", "Deleted", "Closed" ]Query state. Candidate = query created but not yet opened; Opened = action required; Answered = awaiting review; Deleted = removed from workflow; Closed = finalised.Example:Opened -
studyRoleId: string
(uuid)
Study role unique GUID.
-
studyVersionStart: string
(date-time)
Data element version start date-time.Example:
2024-04-02T17:33:03.958Z -
subjectId: string
(uuid)
Subject unique GUID.
-
subjectNumber: string
Study subject number.Example:
site12 -
userId: string
(uuid)
User unique GUID.
-
userName: string
User Name for the Query operationExample:
system -
versionEnd: string
(date-time)
Timestamp when this version of the query ended. Null indicates the version is current.Example:
2024-04-02T17:35:13.333Z -
versionStart: string
(date-time)
Timestamp when this version of the query became active.Example:
2024-04-02T17:33:03.958Z
Examples
400 Response
Request validation failed due to missing, invalid, or inconsistent request data.
Root Schema : Response DTO
Type:
objectBase envelope returned by Query APIs. Use the status field to determine whether result or errorData is populated.
Show Source
-
errorData: object
Error details DTO
Standard structure used to describe errors returned by Query APIs.
-
result: object
result
Result payload returned when status equals success.
-
status: string
Read Only:
trueAllowed Values:[ "success", "failed" ]Overall execution status. Value is success when result is populated and failed when errorData is returned.Example:success -
version: string
Read Only:
trueSemantic version of the response envelope.Example:1
Example:
{\n \"status\": \"success\",\n \"result\": {\n \"id\": \"AE33A9096BF548BBB29A96E399E9FBBB\",\n \"state\": \"Answered\"\n },\n \"errorData\": null,\n \"version\": \"1\"\n}Nested Schema : Error details DTO
Type:
objectStandard structure used to describe errors returned by Query APIs.
Show Source
-
details: object
QueryRestErrorDetail
Read Only:
trueContext object returned when additional error metadata is available. -
errorCode: string
Read Only:
trueMachine-readable error code that identifies the failure.Example:QRY-5000 -
errorMessage: string
Read Only:
trueHuman-readable explanation describing why the request failed.Example:Unexpected server error.
Example:
{
"errorCode":"QRY-5000",
"errorMessage":"Unexpected server error.",
"details":{
"requestId":"3b3b8f31-87a3-4dd2-8b9d-21d0c93ef27a",
"supportCode":"QRY-5000",
"hint":"Retry request after verifying the study mode."
}
}Nested Schema : result
Type:
objectResult payload returned when status equals success.
Example:
{
"opened":3,
"answered":1,
"closed":2
}Nested Schema : QueryRestErrorDetail
Type:
objectRead Only:
trueContext object returned when additional error metadata is available.
Show Source
-
hint: string
Client-facing guidance that clarifies how to resolve or retry the request.Example:
Retry request after verifying the study mode. -
requestId: string
Unique identifier that can be supplied to Oracle Support when troubleshooting.Example:
3b3b8f31-87a3-4dd2-8b9d-21d0c93ef27a -
supportCode: string
Support or incident code associated with the error source.Example:
QRY-5000
Example:
{
"requestId":"3b3b8f31-87a3-4dd2-8b9d-21d0c93ef27a",
"supportCode":"QRY-5000",
"hint":"Retry request"
}Examples
404 Response
The query could not be found.
Root Schema : Response DTO
Type:
objectBase envelope returned by Query APIs. Use the status field to determine whether result or errorData is populated.
Show Source
-
errorData: object
Error details DTO
Standard structure used to describe errors returned by Query APIs.
-
result: object
result
Result payload returned when status equals success.
-
status: string
Read Only:
trueAllowed Values:[ "success", "failed" ]Overall execution status. Value is success when result is populated and failed when errorData is returned.Example:success -
version: string
Read Only:
trueSemantic version of the response envelope.Example:1
Example:
{\n \"status\": \"success\",\n \"result\": {\n \"id\": \"AE33A9096BF548BBB29A96E399E9FBBB\",\n \"state\": \"Answered\"\n },\n \"errorData\": null,\n \"version\": \"1\"\n}Nested Schema : Error details DTO
Type:
objectStandard structure used to describe errors returned by Query APIs.
Show Source
-
details: object
QueryRestErrorDetail
Read Only:
trueContext object returned when additional error metadata is available. -
errorCode: string
Read Only:
trueMachine-readable error code that identifies the failure.Example:QRY-5000 -
errorMessage: string
Read Only:
trueHuman-readable explanation describing why the request failed.Example:Unexpected server error.
Example:
{
"errorCode":"QRY-5000",
"errorMessage":"Unexpected server error.",
"details":{
"requestId":"3b3b8f31-87a3-4dd2-8b9d-21d0c93ef27a",
"supportCode":"QRY-5000",
"hint":"Retry request after verifying the study mode."
}
}Nested Schema : result
Type:
objectResult payload returned when status equals success.
Example:
{
"opened":3,
"answered":1,
"closed":2
}Nested Schema : QueryRestErrorDetail
Type:
objectRead Only:
trueContext object returned when additional error metadata is available.
Show Source
-
hint: string
Client-facing guidance that clarifies how to resolve or retry the request.Example:
Retry request after verifying the study mode. -
requestId: string
Unique identifier that can be supplied to Oracle Support when troubleshooting.Example:
3b3b8f31-87a3-4dd2-8b9d-21d0c93ef27a -
supportCode: string
Support or incident code associated with the error source.Example:
QRY-5000
Example:
{
"requestId":"3b3b8f31-87a3-4dd2-8b9d-21d0c93ef27a",
"supportCode":"QRY-5000",
"hint":"Retry request"
}Examples