Aggregate data for Oracle CRF Submit
post
/ec-reporting-svc/rest/v1.0/crf/reports
Provides the aggregated/collated data based on the given query parameters. Submit required field specifications in the request body.
Right: ReportingPost.
Right: ReportingPost.
Request
Query Parameters
-
format: string
Format CASEBOOK or UNIQUEExample:
CASEBOOK -
mode: string
Mode of the study. Accepts test, active, or training.Example:
test -
reportName(required): string
Report name.Example:
CRF_SUBJECT_DATA -
studyId(required): string(uuid)
Study identifier. Provide as uppercase HEX UUID.Example:
D5E16DD550CB4AD1B330E0D09B4B8F3F
Supported Media Types
- application/json
Root Schema : schema
Type:
objectSpecifies fields for report generation
Show Source
-
extFieldSpecsList: object
extFieldSpecsList
Contains field details.
-
fieldSpecsList: object
fieldSpecsList
Contains field details.
Nested Schema : extFieldSpecsList
Type:
objectContains field details.
Show Source
-
fieldName(required): string
Minimum Length:
0Maximum Length:255Field nameExample:siteIds -
fieldSequence: integer
(int32)
Minimum Value:
0Field sequenceExample:1 -
fieldType(required): string
Minimum Length:
0Maximum Length:50Field typeExample:list -
fieldValueList(required): string
List of values for the FieldExample:
["D5E16DD550CB4AD1B330E0D09B4B8F3F","A5E16DD550CB4AD1B330E0D09B4B8F3F"]
Nested Schema : fieldSpecsList
Type:
objectContains field details.
Show Source
-
fieldName(required): string
Minimum Length:
0Maximum Length:255Field nameExample:siteIds -
fieldSequence: integer
(int32)
Minimum Value:
0Field sequenceExample:1 -
fieldType(required): string
Minimum Length:
0Maximum Length:50Field typeExample:list -
fieldValueList(required): string
List of values for the FieldExample:
["D5E16DD550CB4AD1B330E0D09B4B8F3F","A5E16DD550CB4AD1B330E0D09B4B8F3F"]
Examples
Back to Top
Response
Supported Media Types
- application/json
200 Response
Success Returns a BaseResponse containing an ODM object.
Root Schema : ODM
Type:
objectOracle Clinical Data Management model object for CRF report result data, including study, admin, reference, clinical, and associated metadata.
Show Source
-
AdminData: object
AdminData
ODM AdminData section: definition of users, locations, digital signatures, and study OID metadata.
-
Archival: string
Archival indicator (YES or NO).Example:
YES -
AsOfDateTime: string
As-of timestamp for this ODM.Example:
2025-10-26T23:59:59Z -
Association: object
Association
Study-level associations (e.g. investigator, site, etc.).
-
ClinicalData: object
ClinicalData
List of clinical data subjects/visits/logs.
-
CreationDateTime: string
ISO timestamp for creation of this ODM.Example:
2025-10-27T10:00:00Z -
Description: string
Description of this ODM payload/report.Example:
CRF Report ODM data for sample study. -
FileOID: string
File OID of generated ODM file. (UUID uppercase hex format)Example:
FFBAA1C5287D40679B1ED676151C7F63 -
FileType: string
Output file type of ODM report.Example:
PDF -
Granularity: string
Granularity of report (e.g. ALL, SUBJECT, VISIT).Example:
ALL -
ID: string
Unique report/package identifier (UUID uppercase hex format).Example:
71C8CED11E264FFDB165B07AF5117602 -
ODMVersion: string
ODM version spec string.Example:
1.3.2 -
Originator: string
Originating system for ODM.Example:
ORACLE_CDM_SYSTEM -
PriorFileOID: string
File OID of the prior ODM in the generation sequence.Example:
9678B5A2C18C4A20A1400729839CC661 -
ReferenceData: object
ReferenceData
Reference data map.
-
Signature: object
Signature
Array of digital signatures appended to this CRF data.
-
SourceSystem: string
Source system identifier.Example:
ClinicalOne -
SourceSystemVersion: string
Source system version.Example:
v3.0.0 -
Study: object
Study
ODM Study object
Nested Schema : AdminData
Type:
objectODM AdminData section: definition of users, locations, digital signatures, and study OID metadata.
Show Source
-
Location: object
Location
Physical or logical locations for the study.
-
SignatureDef: object
SignatureDef
Study-level signature definitions.
-
StudyOID: string
Study OID to which this admin data refers.Example:
D5E16DD550CB4AD1B330E0D09B4B8F3F -
User: object
User
Represents a user in the ODM AdminData structure (site personnel, investigator, etc).
Example:
{
"user":[
{
"userId":"A8C41D8062A14FCC89EDA475C3E3AF12",
"userName":"adminuser"
}
],
"location":[
{
"locationId":"LOC101",
"locationName":"Site 101"
}
],
"signatureDef":[
{
"sigType":"Data Entry"
}
],
"studyOID":"D5E16DD550CB4AD1B330E0D09B4B8F3F"
}Nested Schema : Association
Type:
objectStudy-level associations (e.g. investigator, site, etc.).
Show Source
Example:
[
{
"role":"INVESTIGATOR"
}
]Nested Schema : ClinicalData
Type:
objectList of clinical data subjects/visits/logs.
Show Source
-
Annotations: array
Annotations
-
AuditRecords: array
AuditRecords
-
MetaDataVersionOID: string
-
Signatures: array
Signatures
-
StudyOID: string
-
SubjectData: array
SubjectData
Example:
[
{
"subjectOID":"SUBJ1"
}
]Nested Schema : ReferenceData
Type:
objectReference data map.
Show Source
-
Annotations: object
Annotations
List of annotations
-
AuditRecords: object
AuditRecords
List of audit records
-
ItemGroupData: object
ItemGroupData
List of item group data
-
MetaDataVersionOID: string
OID for referenced MetaDataVersionExample:
MDV1 -
Signatures: object
Signatures
List of signatures
-
StudyOID: string
OID of referenced studyExample:
STUDY123
Example:
[
{
"refType":"CDISC"
}
]Nested Schema : Signature
Type:
objectArray of digital signatures appended to this CRF data.
Show Source
-
ID: string
-
KeyInfo: object
KeyInfoType
-
Object: array
Object
-
SignatureValue: object
SignatureValueType
-
SignedInfo: object
SignedInfoType
Example:
[
{
"signedBy":"Dr. J. Smith"
}
]Nested Schema : Study
Type:
objectODM Study object
Show Source
-
BasicDefinitions: object
BasicDefinitions
Root-level definitions for basic units and reference types in the ODM Study.
-
GlobalVariables: object
GlobalVariables
ODM GlobalVariables for a Study, providing human-readable study description and identifiers.
-
MetaDataVersion: object
MetaDataVersion
List of metadata versions for the study.
-
OID: string
Unique object identifier for the study, uppercase HEX UUID.Example:
D5E16DD550CB4AD1B330E0D09B4B8F3F
Example:
[
{
"studyOID":"S123"
}
]Nested Schema : Location
Type:
objectPhysical or logical locations for the study.
Show Source
-
LocationType: string
Allowed Values:
[ "SPONSOR", "SITE", "CRO", "LAB", "OTHER" ] -
MetaDataVersionRef: array
MetaDataVersionRef
-
Name: string
-
OID: string
Nested Schema : User
Type:
objectRepresents a user in the ODM AdminData structure (site personnel, investigator, etc).
Show Source
-
Address: object
Address
Postal or location address for an ODM user or site, with support for street, city, state, country, and postal code.
-
Certificate: object
Certificate
Digital certificate or identity for an ODM User.
-
DisplayName: object
DisplayName
Human-readable display name for the ODM User.
-
Email: object
Email
Email address record for an ODM user.
-
Fax: object
Fax
Fax number/contact for an ODM User.
-
FirstName: object
FirstName
User's first name.
-
FullName: object
FullName
User's full name as a single value.
-
LastName: object
LastName
User's last/family/surname.
-
LocationRef: object
LocationRef
Reference to a study/site location for an ODM User.
-
LoginName: object
LoginName
Login name or identifier for the ODM User.
-
OID: string
User's object identifier/UUID (uppercase hex).Example:
A8C41D8062A14FCC89EDA475C3E3AF12 -
Organization: object
Organization
Organization name associated with the User.
-
Pager: object
Pager
Pager number or contact info for an ODM User.
-
Phone: object
Phone
Phone number/contact entry for ODM User.
-
Picture: object
Picture
Profile or avatar image info for ODM User.
-
UserType: string
Allowed Values:
[ "SPONSOR", "INVESTIGATOR", "LAB", "OTHER" ]Enumeration of possible user types/roles for ODM User.
Nested Schema : Address
Type:
objectPostal or location address for an ODM user or site, with support for street, city, state, country, and postal code.
Show Source
-
City: object
City
City for this address.
-
Country: object
Country
Country.
-
OtherText: object
OtherText
Additional address information.
-
PostalCode: object
PostalCode
Postal or ZIP code.
-
StateProv: object
StateProv
State or province.
-
StreetName: object
StreetName
List of street name lines.
Nested Schema : Certificate
Type:
objectDigital certificate or identity for an ODM User.
Show Source
-
Value: string
Certificate/credential identifier.Example:
CERT123
Nested Schema : DisplayName
Type:
objectHuman-readable display name for the ODM User.
Show Source
-
Value: string
Value for the display name of the user.Example:
Dr. J. Smith
Nested Schema : Email
Type:
objectEmail address record for an ODM user.
Show Source
-
Value: string
Email address.Example:
john.smith@email.com
Nested Schema : Fax
Type:
objectFax number/contact for an ODM User.
Show Source
-
Value: string
Fax number.Example:
555-5678
Nested Schema : FirstName
Type:
objectUser's first name.
Show Source
-
Value: string
Given name of the user.Example:
John
Example:
{
"value":"John"
}Nested Schema : FullName
Type:
objectUser's full name as a single value.
Show Source
-
Value: string
Full name for the user.Example:
John Smith
Example:
{
"value":"John Smith"
}Nested Schema : LastName
Type:
objectUser's last/family/surname.
Show Source
-
Value: string
Surname of the user.Example:
Smith
Example:
{
"value":"Smith"
}Nested Schema : LocationRef
Type:
objectReference to a study/site location for an ODM User.
Show Source
-
LocationOID: string
OID/ID for the associated location.Example:
LOC101
Nested Schema : LoginName
Type:
objectLogin name or identifier for the ODM User.
Show Source
-
Value: string
Login/account name for the user.Example:
INVEST001
Nested Schema : Organization
Type:
objectOrganization name associated with the User.
Show Source
-
Value: string
Name of the user's organization.Example:
Site 101 Hospital
Example:
{
"value":"Site 101 Hospital"
}Nested Schema : Pager
Type:
objectPager number or contact info for an ODM User.
Show Source
-
Value: string
Pager contact number or info.Example:
555-1234
Nested Schema : Phone
Type:
objectPhone number/contact entry for ODM User.
Show Source
-
Value: string
Phone number.Example:
555-9876
Example:
{
"value":"555-9876"
}Nested Schema : Picture
Type:
objectProfile or avatar image info for ODM User.
Show Source
-
ImageType: string
MIME/image type information, e.g. image/jpegExample:
image/jpeg -
PictureFileName: string
Picture filename or image reference.Example:
photo.jpg
Nested Schema : items
Type:
objectNested Schema : Annotation
Type:
Show Source
object-
Comment: object
Comment
Annotation comment object
-
Flag: object
Flag
Flags associated with this annotation
-
ID: string
Annotation identifierExample:
AN1 -
SeqNum: integer
(int32)
Sequence number for annotationExample:
1 -
TransactionType: string
Allowed Values:
[ "INSERT", "UPDATE", "REMOVE", "UPSERT", "CONTEXT" ]Transaction type for annotationExample:INSERT
Nested Schema : Comment
Type:
objectAnnotation comment object
Show Source
-
SponsorOrSite: string
Allowed Values:
[ "SPONSOR", "SITE" ] -
Value: string
Example:
{
"value":"Requires follow-up"
}Nested Schema : Flag
Type:
objectFlags associated with this annotation
Show Source
Example:
[
{
"flagOID":"FLAG1"
}
]Nested Schema : AuditRecord
Type:
Show Source
object-
DateTimeStamp: object
DateTimeStamp
Timestamp of signing
-
ID: string
Audit record identifierExample:
AUD1 -
LocationRef: object
LocationRef
Reference to a study/site location for an ODM User.
-
ReasonForChange: object
ReasonForChange
Reason for data change
-
SourceID: object
SourceID
Source identifier
-
UserRef: object
UserRef
Reference to user
Nested Schema : DateTimeStamp
Type:
objectTimestamp of signing
Show Source
Example:
{
"value":"2025-10-27T10:00:00Z"
}Nested Schema : LocationRef
Type:
objectReference to a study/site location for an ODM User.
Show Source
-
LocationOID: string
OID/ID for the associated location.Example:
LOC101
Example:
{
"locationOID":"LOC101"
}Nested Schema : ReasonForChange
Type:
objectReason for data change
Show Source
Example:
{
"value":"Correction"
}Nested Schema : UserRef
Type:
objectReference to user
Show Source
-
UserOID: string
OID of the referenced userExample:
USER123
Example:
{
"userOID":"USER123"
}Nested Schema : Signature
Type:
Show Source
object-
CryptoBindingManifest: object
CryptoBindingManifest
Crypto binding manifest details
-
DateTimeStamp: object
DateTimeStamp
Timestamp of signing
-
ID: string
Signature identifierExample:
SIG123 -
LocationRef: object
LocationRef
Reference to a study/site location for an ODM User.
-
SignatureRef: object
SignatureRef
Reference to signature
-
UserRef: object
UserRef
Reference to user
Nested Schema : CryptoBindingManifest
Type:
objectCrypto binding manifest details
Show Source
Example:
{
"manifestID":"CBM1"
}Nested Schema : SignatureRef
Type:
objectReference to signature
Show Source
Example:
{
"refID":"SIGREF1"
}Nested Schema : SubjectData
Type:
Show Source
object-
Annotation: array
Annotation
-
AuditRecord: object
AuditRecord
-
Initials: string
-
InvestigatorRef: object
InvestigatorRef
-
Signature: object
Signature
-
SiteRef: object
SiteRef
-
StudyEventData: array
StudyEventData
-
SubjectHistory: array
SubjectHistory
-
SubjectKey: string
-
TransactionType: string
Allowed Values:
[ "INSERT", "UPDATE", "REMOVE", "UPSERT", "CONTEXT" ] -
TransferData: array
TransferData
Nested Schema : FormData
Type:
Show Source
object-
Annotation: array
Annotation
-
ArchiveLayoutRef: object
ArchiveLayoutRef
-
AuditRecord: object
AuditRecord
-
FormOID: string
-
FormRepeatKey: string
-
FormStatus: string
-
ItemGroupData: array
ItemGroupData
-
NotDoneValue: string
-
Signature: object
Signature
-
Signatures: object
Signatures
-
Status: string
-
TitleAddendum: string
-
TransactionType: string
Allowed Values:
[ "INSERT", "UPDATE", "REMOVE", "UPSERT", "CONTEXT" ]
Nested Schema : ItemGroupData
Type:
Show Source
object-
Annotation: object
Annotation
Annotations for the item group
-
AuditRecord: object
AuditRecord
-
ItemGroupOID: string
OID for this item groupExample:
IG1 -
ItemGroupRepeatKey: string
Repeat key for this groupExample:
RPT1 -
Items: object
Items
Contained item data list
-
Signature: object
Signature
-
TransactionType: string
Allowed Values:
[ "INSERT", "UPDATE", "REMOVE", "UPSERT", "CONTEXT" ]Transaction type for the groupExample:INSERT
Nested Schema : Annotation
Type:
objectAnnotations for the item group
Show Source
-
Comment: object
Comment
Annotation comment object
-
Flag: object
Flag
Flags associated with this annotation
-
ID: string
Annotation identifierExample:
AN1 -
SeqNum: integer
(int32)
Sequence number for annotationExample:
1 -
TransactionType: string
Allowed Values:
[ "INSERT", "UPDATE", "REMOVE", "UPSERT", "CONTEXT" ]Transaction type for annotationExample:INSERT
Example:
[
{
"annotationOID":"AN1"
}
]Nested Schema : Items
Type:
objectContained item data list
Show Source
-
Annotation: object
Annotation
Annotations for this item
-
AuditRecord: object
AuditRecord
-
DocumentId: string
Document ID referenceExample:
DOC1 -
DocumentVersion: number
Document versionExample:
1 -
ItemOID: string
OID of the itemExample:
ITM1 -
MeasurementUnitRef: object
MeasurementUnitRef
Measurement unit reference
-
NotDone: string
Whether item is not done (0 or 1)Example:
0 -
ParentItemOID: string
OID of parent itemExample:
ITM_PARENT -
SelectedCodeListItemsType: string
Selected code list items typeExample:
CODE_A -
Signature: object
Signature
-
TransactionType: string
Allowed Values:
[ "INSERT", "UPDATE", "REMOVE", "UPSERT", "CONTEXT" ]Transaction typeExample:UPDATE -
Value: string
Value for this itemExample:
130
Example:
[
{
"itemOID":"ITM1"
}
]Nested Schema : Flag
Type:
objectFlags associated with this annotation
Show Source
Example:
[
{
"flagOID":"FLAG1"
}
]Nested Schema : Annotation
Type:
objectAnnotations for this item
Show Source
-
Comment: object
Comment
Annotation comment object
-
Flag: object
Flag
Flags associated with this annotation
-
ID: string
Annotation identifierExample:
AN1 -
SeqNum: integer
(int32)
Sequence number for annotationExample:
1 -
TransactionType: string
Allowed Values:
[ "INSERT", "UPDATE", "REMOVE", "UPSERT", "CONTEXT" ]Transaction type for annotationExample:INSERT
Example:
[
{
"id":"AN1"
}
]Nested Schema : MeasurementUnitRef
Type:
objectMeasurement unit reference
Show Source
-
MeasurementUnitOID: string
OID of the referenced measurement unitExample:
U1
Example:
{
"measurementUnitOID":"U1"
}Nested Schema : Flag
Type:
objectFlags associated with this annotation
Show Source
Example:
[
{
"flagOID":"FLAG1"
}
]Nested Schema : Annotations
Type:
objectList of annotations
Show Source
Example:
[
{
"annotationOID":"AN1"
}
]Nested Schema : AuditRecords
Type:
objectList of audit records
Show Source
Example:
[
{
"auditOID":"AUD1"
}
]Nested Schema : ItemGroupData
Type:
objectList of item group data
Show Source
-
Annotation: object
Annotation
Annotations for the item group
-
AuditRecord: object
AuditRecord
-
ItemGroupOID: string
OID for this item groupExample:
IG1 -
ItemGroupRepeatKey: string
Repeat key for this groupExample:
RPT1 -
Items: object
Items
Contained item data list
-
Signature: object
Signature
-
TransactionType: string
Allowed Values:
[ "INSERT", "UPDATE", "REMOVE", "UPSERT", "CONTEXT" ]Transaction type for the groupExample:INSERT
Example:
[
{
"groupOID":"IG1"
}
]Nested Schema : Signatures
Type:
objectList of signatures
Show Source
Example:
[
{
"signatureOID":"SIG1"
}
]Nested Schema : Annotation
Type:
objectAnnotations for the item group
Show Source
-
Comment: object
Comment
Annotation comment object
-
Flag: object
Flag
Flags associated with this annotation
-
ID: string
Annotation identifierExample:
AN1 -
SeqNum: integer
(int32)
Sequence number for annotationExample:
1 -
TransactionType: string
Allowed Values:
[ "INSERT", "UPDATE", "REMOVE", "UPSERT", "CONTEXT" ]Transaction type for annotationExample:INSERT
Example:
[
{
"annotationOID":"AN1"
}
]Nested Schema : Items
Type:
objectContained item data list
Show Source
-
Annotation: object
Annotation
Annotations for this item
-
AuditRecord: object
AuditRecord
-
DocumentId: string
Document ID referenceExample:
DOC1 -
DocumentVersion: number
Document versionExample:
1 -
ItemOID: string
OID of the itemExample:
ITM1 -
MeasurementUnitRef: object
MeasurementUnitRef
Measurement unit reference
-
NotDone: string
Whether item is not done (0 or 1)Example:
0 -
ParentItemOID: string
OID of parent itemExample:
ITM_PARENT -
SelectedCodeListItemsType: string
Selected code list items typeExample:
CODE_A -
Signature: object
Signature
-
TransactionType: string
Allowed Values:
[ "INSERT", "UPDATE", "REMOVE", "UPSERT", "CONTEXT" ]Transaction typeExample:UPDATE -
Value: string
Value for this itemExample:
130
Example:
[
{
"itemOID":"ITM1"
}
]Nested Schema : Flag
Type:
objectFlags associated with this annotation
Show Source
Example:
[
{
"flagOID":"FLAG1"
}
]Nested Schema : Annotation
Type:
objectAnnotations for this item
Show Source
-
Comment: object
Comment
Annotation comment object
-
Flag: object
Flag
Flags associated with this annotation
-
ID: string
Annotation identifierExample:
AN1 -
SeqNum: integer
(int32)
Sequence number for annotationExample:
1 -
TransactionType: string
Allowed Values:
[ "INSERT", "UPDATE", "REMOVE", "UPSERT", "CONTEXT" ]Transaction type for annotationExample:INSERT
Example:
[
{
"id":"AN1"
}
]Nested Schema : Flag
Type:
objectFlags associated with this annotation
Show Source
Example:
[
{
"flagOID":"FLAG1"
}
]Nested Schema : items
Type:
objectNested Schema : items
Type:
objectNested Schema : items
Type:
objectNested Schema : items
Type:
objectNested Schema : items
Type:
objectNested Schema : items
Type:
objectNested Schema : BasicDefinitions
Type:
objectRoot-level definitions for basic units and reference types in the ODM Study.
Show Source
-
MeasurementUnit: object
MeasurementUnit
A measurement unit reference used in study forms, such as mg/dL.
Example:
{
"unitDef":[
{
"unitOID":"U1"
}
]
}Nested Schema : GlobalVariables
Type:
objectODM GlobalVariables for a Study, providing human-readable study description and identifiers.
Show Source
-
ProtocolName: object
ProtocolName
Protocol identifier/name for the ODM Study.
-
StudyDescription: object
StudyDescription
Free-text description of the ODM Study.
-
StudyName: object
StudyName
Human-readable display name for the ODM Study.
Example:
{
"studyName":{
"value":"TESTSTUDY"
}
}Nested Schema : MetaDataVersion
Type:
objectList of metadata versions for the study.
Show Source
-
CodeList: object
CodeList
Code lists for data values
-
ConditionDef: object
ConditionDef
Condition definitions for logic
-
Description: string
Description of this study versionExample:
Main Study Metadata for Diabetes Trial -
FormDef: object
FormDef
Form definitions
-
ImputationMethod: object
ImputationMethod
Imputation methods
-
Include: object
Include
Reference to parent include structure
-
ItemDef: object
ItemDef
Item definitions
-
ItemGroupDef: object
ItemGroupDef
Item group definitions
-
MethodDef: object
MethodDef
Custom method definitions
-
Name: string
Name of this study versionExample:
Main Study MetaData v1 -
OID: string
Unique identifier for this MetaDataVersionExample:
MDV1 -
Presentation: object
Presentation
Presentations used in eCRFs
-
Protocol: object
Protocol
Protocol metadata for this study version
-
StudyEventDef: object
StudyEventDef
Study event definitions
Example:
[
{
"versionOID":"MDV1"
}
]Nested Schema : MeasurementUnit
Type:
objectA measurement unit reference used in study forms, such as mg/dL.
Show Source
-
Alias: object
Alias
A synonym, translation, or locale-specific label for a MeasurementUnit.
-
Name: string
Formal name of this measurement unit.Example:
mg/dL -
OID: string
Unique OID for this measurement unit. UUID uppercase hex.Example:
F71C0A5ED4E448EFB2A7A2B716A39216 -
Symbol: object
Symbol
Symbol element for a MeasurementUnit.
Nested Schema : Alias
Type:
objectA synonym, translation, or locale-specific label for a MeasurementUnit.
Show Source
-
Context: string
Locale, region, or terminology context.Example:
US -
Name: string
Alternative or alias name for the unit in this context.Example:
mg per deciliter
Nested Schema : Symbol
Type:
objectSymbol element for a MeasurementUnit.
Show Source
-
TranslatedText: object
TranslatedText
A localizable or translated representation of a symbol, label, or similar text element.
Example:
{
"translatedText":[
{
"lang":"en",
"value":"mg/dL"
}
]
}Nested Schema : TranslatedText
Type:
objectA localizable or translated representation of a symbol, label, or similar text element.
Show Source
-
lang: string
Language code for this translation, e.g. 'en'.Example:
en -
Value: string
Text value for this locale/language.Example:
mg/dL
Example:
{
"lang":"en",
"value":"mg/dL"
}Nested Schema : ProtocolName
Type:
objectProtocol identifier/name for the ODM Study.
Show Source
-
Value: string
Protocol name/code for the Study.Example:
P-2024-0001
Nested Schema : StudyDescription
Type:
objectFree-text description of the ODM Study.
Show Source
-
Value: string
Free-text description of the Study.Example:
Phase 3, double blind, randomized clinical study in Diabetes.
Nested Schema : StudyName
Type:
objectHuman-readable display name for the ODM Study.
Show Source
-
Value: string
Display name for the Study.Example:
Sample Study
Example:
{
"value":"Sample Study"
}Nested Schema : CodeList
Type:
objectCode lists for data values
Show Source
-
Alias: array
Alias
-
DataType: string
Allowed Values:
[ "INTEGER", "FLOAT", "TEXT", "STRING" ] -
Description: object
Description
Item description details
-
EnumeratedItem: array
EnumeratedItem
-
ExternalCodeList: object
ExternalCodeList
-
Items: array
Items
-
Name: string
-
OID: string
-
SasformatName: string
Example:
[
{
"codeListOID":"CL1"
}
]Nested Schema : ConditionDef
Type:
objectCondition definitions for logic
Show Source
-
Alias: array
Alias
-
Description: object
Description
Item description details
-
FormalExpression: array
FormalExpression
-
Name: string
-
OID: string
Example:
[
{
"conditionOID":"C1"
}
]Nested Schema : FormDef
Type:
objectForm definitions
Show Source
-
Alias: array
Alias
-
ArchiveLayout: array
ArchiveLayout
-
Description: object
Description
Item description details
-
HasIPR: boolean
-
ID: string
-
ItemGroupRef: array
ItemGroupRef
-
Name: string
-
Note: string
-
OID: string
-
Repeating: string
Allowed Values:
[ "Yes", "No" ] -
RevisionDate: string
Example:
[
{
"formOID":"F1"
}
]Nested Schema : ImputationMethod
Type:
objectImputation methods
Show Source
Example:
[
{
"methodOID":"IM1"
}
]Nested Schema : Include
Type:
objectReference to parent include structure
Show Source
-
MetaDataVersionOID: string
OID of the referenced MetaDataVersionExample:
MDV1 -
StudyOID: string
OID of the referenced studyExample:
STUDY1
Example:
{
"href":"/includes/INC123"
}Nested Schema : ItemDef
Type:
objectItem definitions
Show Source
-
Alias: object
Alias
A synonym, translation, or locale-specific label for a MeasurementUnit.
-
Calculated: string
Is this item calculated?Example:
1 -
CaptionAlignment: string
Allowed Values:
[ "0", "1", "2", "3", "4", "5", "6" ]Caption alignmentExample:INF_LEFT -
CaptionText: string
UI caption textExample:
Please enter your name -
CodeListRef: object
CodeListRef
Reference to code list
-
Comment: string
Free-text commentExample:
This is a calculated item. -
ControlLayout: string
Allowed Values:
[ "0", "1", "2", "3", "4", "5" ]UI control layout styleExample:INF_HORIZONTAL -
ControlType: string
Allowed Values:
[ "pulldown", "text", "group", "radiogroup", "checkbox", "calendar", "element", "calculated", "instructionaltext", "file" ]UI control typeExample:TEXTBOX -
DataType: string
Allowed Values:
[ "integer", "float", "date", "datetime", "time", "text", "string", "double", "URI", "boolean", "hexBinary", "base64Binary", "hexFloat", "base64Float", "partialDate", "partialTime", "partialDatetime", "durationDatetime", "intervalDatetime", "incompleteDatetime", "incompleteDate", "incompleteTime" ]Data type (e.g., STRING, INT)Example:STRING -
Description: object
Description
Item description details
-
DisplayMask: string
Display mask for inputExample:
999-99-9999 -
EndYear: string
End year for date inputExample:
2025 -
ExternalQuestion: object
ExternalQuestion
Additional question taken from external systems
-
InitialRowCount: string
Initial number of rowsExample:
1 -
IsDynamic: integer
(int32)
Is this item dynamic?Example:
0 -
IsSmartItem: integer
(int32)
Is this a smart item?Example:
1 -
ItemRef: object
ItemRef
Item reference list
-
Length: integer
(int32)
Length of string/numericExample:
255 -
MeasurementUnitRef: object
MeasurementUnitRef
Measurement units for this item
-
Name: string
Item nameExample:
Height -
OID: string
Unique OIDExample:
ITM1 -
Origin: string
Item's origin dataExample:
derived -
Question: object
Question
The main study question
-
RangeCheck: object
RangeCheck
Validation range checks
-
Role: object
Role
Item roles (reviewer, data entry, etc)
-
SasfieldName: string
-
SdsvarName: string
-
SelectionValue: string
Selection value for this itemExample:
Y -
SignificantDigits: integer
(int32)
Number of significant digitsExample:
2 -
StartYear: string
Start year for date inputExample:
2000 -
UnknownMask: string
Unknown input maskExample:
UNK
Example:
[
{
"itemOID":"I1"
}
]Nested Schema : ItemGroupDef
Type:
objectItem group definitions
Show Source
-
Alias: array
Alias
-
Comment: string
-
Description: object
Description
Item description details
-
Domain: string
-
IsReferenceData: string
Allowed Values:
[ "Yes", "No" ] -
ItemRef: array
ItemRef
-
Name: string
-
OID: string
-
Origin: string
-
Purpose: string
-
Repeating: string
Allowed Values:
[ "Yes", "No" ] -
Role: string
-
SasdatasetName: string
Example:
[
{
"groupOID":"IG1"
}
]Nested Schema : MethodDef
Type:
objectCustom method definitions
Show Source
-
Alias: array
Alias
-
Description: object
Description
Item description details
-
FormalExpression: array
FormalExpression
-
Name: string
-
OID: string
-
Type: string
Allowed Values:
[ "COMPUTATION", "IMPUTATION", "TRANSPOSE", "OTHER" ]
Example:
[
{
"methodOID":"M1"
}
]Nested Schema : Presentation
Type:
objectPresentations used in eCRFs
Show Source
Example:
[
{
"presentationOID":"P1"
}
]Nested Schema : Protocol
Type:
objectProtocol metadata for this study version
Show Source
-
Alias: object
Alias
A synonym, translation, or locale-specific label for a MeasurementUnit.
-
Description: object
Description
Item description details
-
StudyEventRef: object
StudyEventRef
Referenced study events
Example:
{
"protocolName":"PROT1"
}Nested Schema : StudyEventDef
Type:
objectStudy event definitions
Show Source
-
Alias: object
Alias
A synonym, translation, or locale-specific label for a MeasurementUnit.
-
Category: string
Event categoryExample:
Main -
Description: object
Description
Item description details
-
FormRef: object
FormRef
Associated form references
-
Name: string
Event nameExample:
Screening Event -
OID: string
Unique identifier OID for the eventExample:
SE1 -
Repeating: string
Allowed Values:
[ "Yes", "No" ]Whether this event may repeatExample:Yes -
Type: string
Allowed Values:
[ "Scheduled", "Unscheduled", "Common" ]Type of eventExample:SCHEDULED
Example:
[
{
"eventOID":"SE1"
}
]Nested Schema : Alias
Type:
Show Source
array-
Array of:
object Alias
A synonym, translation, or locale-specific label for a MeasurementUnit.
Nested Schema : Description
Type:
objectItem description details
Show Source
-
TranslatedText: object
TranslatedText
A localizable or translated representation of a symbol, label, or similar text element.
Example:
{
"value":"desc"
}Nested Schema : Alias
Type:
objectA synonym, translation, or locale-specific label for a MeasurementUnit.
Show Source
-
Context: string
Locale, region, or terminology context.Example:
US -
Name: string
Alternative or alias name for the unit in this context.Example:
mg per deciliter
Example:
[
{
"context":"CDASH",
"name":"SUBJID"
}
]Nested Schema : TranslatedText
Type:
objectA localizable or translated representation of a symbol, label, or similar text element.
Show Source
-
lang: string
Language code for this translation, e.g. 'en'.Example:
en -
Value: string
Text value for this locale/language.Example:
mg/dL
Example:
{
"lang":"en",
"value":"mg/dL"
}Nested Schema : Alias
Type:
Show Source
array-
Array of:
object Alias
A synonym, translation, or locale-specific label for a MeasurementUnit.
Nested Schema : Alias
Type:
Show Source
array-
Array of:
object Alias
A synonym, translation, or locale-specific label for a MeasurementUnit.
Nested Schema : TranslatedText
Type:
Show Source
array-
Array of:
object TranslatedText
A localizable or translated representation of a symbol, label, or similar text element.
Nested Schema : TranslatedText
Type:
objectA localizable or translated representation of a symbol, label, or similar text element.
Show Source
-
lang: string
Language code for this translation, e.g. 'en'.Example:
en -
Value: string
Text value for this locale/language.Example:
mg/dL
Example:
{
"lang":"en",
"value":"mg/dL"
}Nested Schema : Alias
Type:
Show Source
array-
Array of:
object Alias
A synonym, translation, or locale-specific label for a MeasurementUnit.
Nested Schema : FormalExpression
Type:
Show Source
object-
Context: string
Context or language for expressionExample:
XPath -
Value: string
Formal expression for validationExample:
@AGE > 18
Nested Schema : Alias
Type:
Show Source
array-
Array of:
object Alias
A synonym, translation, or locale-specific label for a MeasurementUnit.
Nested Schema : ItemGroupRef
Type:
Show Source
object-
CollectionExceptionConditionOID: string
-
ItemGroupOID: string
-
Mandatory: string
Allowed Values:
[ "Yes", "No" ] -
OrderNumber: integer
Nested Schema : Alias
Type:
objectA synonym, translation, or locale-specific label for a MeasurementUnit.
Show Source
-
Context: string
Locale, region, or terminology context.Example:
US -
Name: string
Alternative or alias name for the unit in this context.Example:
mg per deciliter
Example:
[
{
"context":"CDASH",
"name":"SUBJID"
}
]Nested Schema : CodeListRef
Type:
objectReference to code list
Show Source
-
CodeListOID: string
OID of the referenced code listExample:
CL1
Example:
{
"codeListOID":"CL1"
}Nested Schema : ExternalQuestion
Type:
objectAdditional question taken from external systems
Show Source
Example:
{
"externalId":"Q1"
}Nested Schema : ItemRef
Type:
objectItem reference list
Show Source
-
CollectionExceptionConditionOID: string
OID for collection exception conditionExample:
COND1 -
ImputationMethodOID: string
Imputation method OIDExample:
IMPUTE1 -
ItemOID: string
OID of referenced itemExample:
ITM1 -
KeySequence: integer
(int32)
Key sequence for composite keyExample:
1 -
Mandatory: string
Allowed Values:
[ "Yes", "No" ]Is this item mandatory?Example:Yes -
MethodOID: string
Method OID for derivationExample:
METHOD1 -
OrderNumber: integer
(int32)
Order of the itemExample:
2 -
Role: string
Role of the referenced itemExample:
DataEntry -
RoleCodeListOID: string
OID for role code listExample:
ROLE1
Example:
[
{
"itemOID":"ITM2"
}
]Nested Schema : MeasurementUnitRef
Type:
objectMeasurement units for this item
Show Source
-
MeasurementUnitOID: string
OID of the referenced measurement unitExample:
U1
Example:
[
{
"unitOID":"U1"
}
]Nested Schema : Question
Type:
objectThe main study question
Show Source
-
TranslatedText: object
TranslatedText
A localizable or translated representation of a symbol, label, or similar text element.
Example:
{
"text":"What is your height?"
}Nested Schema : RangeCheck
Type:
objectValidation range checks
Show Source
-
CheckValue: object
CheckValue
Check values for enforcing data validation range
-
Comparator: string
Allowed Values:
[ "LT", "LE", "GT", "GE", "EQ", "NE", "IN", "NOTIN" ]Comparator operationExample:GT -
ErrorMessage: object
ErrorMessage
Error message details for validation error
-
FormalExpression: object
FormalExpression
Formal expressions for advanced data validation
-
MeasurementUnitRef: object
MeasurementUnitRef
Measurement unit reference
-
SoftHard: string
Allowed Values:
[ "SOFT", "HARD" ]Indicates hard or soft validationExample:HARD
Example:
[
{
"checkOID":"RC1"
}
]Nested Schema : Role
Type:
objectItem roles (reviewer, data entry, etc)
Show Source
-
Value: string
Value or name of the roleExample:
DataEntry
Example:
[
{
"roleName":"DataEntry"
}
]Nested Schema : TranslatedText
Type:
objectA localizable or translated representation of a symbol, label, or similar text element.
Show Source
-
lang: string
Language code for this translation, e.g. 'en'.Example:
en -
Value: string
Text value for this locale/language.Example:
mg/dL
Example:
{
"lang":"en",
"value":"mg/dL"
}Nested Schema : CheckValue
Type:
objectCheck values for enforcing data validation range
Show Source
-
Value: string
Value to check in a range validationExample:
10
Example:
[
{
"value":"10"
}
]Nested Schema : ErrorMessage
Type:
objectError message details for validation error
Show Source
-
TranslatedText: object
TranslatedText
A localizable or translated representation of a symbol, label, or similar text element.
Example:
{
"lang":"en",
"value":"Error: out of range!"
}Nested Schema : FormalExpression
Type:
objectFormal expressions for advanced data validation
Show Source
-
Context: string
Context or language for expressionExample:
XPath -
Value: string
Formal expression for validationExample:
@AGE > 18
Example:
[
{
"language":"XPath",
"value":"@AGE > 18"
}
]Nested Schema : TranslatedText
Type:
objectA localizable or translated representation of a symbol, label, or similar text element.
Show Source
-
lang: string
Language code for this translation, e.g. 'en'.Example:
en -
Value: string
Text value for this locale/language.Example:
mg/dL
Example:
{
"lang":"en",
"value":"mg/dL"
}Nested Schema : Alias
Type:
Show Source
array-
Array of:
object Alias
A synonym, translation, or locale-specific label for a MeasurementUnit.
Nested Schema : ItemRef
Type:
objectItem reference list
Show Source
-
CollectionExceptionConditionOID: string
OID for collection exception conditionExample:
COND1 -
ImputationMethodOID: string
Imputation method OIDExample:
IMPUTE1 -
ItemOID: string
OID of referenced itemExample:
ITM1 -
KeySequence: integer
(int32)
Key sequence for composite keyExample:
1 -
Mandatory: string
Allowed Values:
[ "Yes", "No" ]Is this item mandatory?Example:Yes -
MethodOID: string
Method OID for derivationExample:
METHOD1 -
OrderNumber: integer
(int32)
Order of the itemExample:
2 -
Role: string
Role of the referenced itemExample:
DataEntry -
RoleCodeListOID: string
OID for role code listExample:
ROLE1
Example:
[
{
"itemOID":"ITM2"
}
]Nested Schema : Alias
Type:
Show Source
array-
Array of:
object Alias
A synonym, translation, or locale-specific label for a MeasurementUnit.
Nested Schema : Alias
Type:
objectA synonym, translation, or locale-specific label for a MeasurementUnit.
Show Source
-
Context: string
Locale, region, or terminology context.Example:
US -
Name: string
Alternative or alias name for the unit in this context.Example:
mg per deciliter
Example:
[
{
"context":"CDASH",
"name":"PROTID"
}
]Nested Schema : StudyEventRef
Type:
objectReferenced study events
Show Source
-
CollectionExceptionConditionOID: string
OID for collection exceptionExample:
COND1 -
Mandatory: string
Allowed Values:
[ "Yes", "No" ]Is this event mandatory?Example:Yes -
OrderNumber: integer
(int32)
Order of the event in scheduleExample:
1 -
StudyEventOID: string
OID of the referenced study eventExample:
SE1
Example:
[
{
"eventOID":"SE1"
}
]Nested Schema : Alias
Type:
objectA synonym, translation, or locale-specific label for a MeasurementUnit.
Show Source
-
Context: string
Locale, region, or terminology context.Example:
US -
Name: string
Alternative or alias name for the unit in this context.Example:
mg per deciliter
Example:
[
{
"context":"CDASH",
"name":"SCREEN"
}
]Nested Schema : FormRef
Type:
objectAssociated form references
Show Source
-
CollectionExceptionConditionOID: string
OID for collection exceptionExample:
COND1 -
FormOID: string
OID of the referenced formExample:
F1 -
Mandatory: string
Allowed Values:
[ "Yes", "No" ]Is this form mandatory in the event?Example:Yes -
OrderNumber: integer
(int32)
Order of this form in the eventExample:
1
Example:
[
{
"formOID":"F1"
}
]Examples
400 Response
Bad Request : Required fields missing or invalid.
Root Schema : BaseResponse
Type:
objectBase response object for all reporting service endpoints, providing a standard structure for status, result, and errorData.
Show Source
-
errorData: object
ErrorResponseData
Structure representing an error response from the reporting service. Contains an error code, human-readable message, and details.
-
result: object
result
Generic result for all request entity types. The type returned depends on endpoint. May be ExecutionLog, list, or error data.
-
status: string
Response status for the request; typically 'success' or 'error'.Example:
success
Nested Schema : ErrorResponseData
Type:
objectStructure representing an error response from the reporting service. Contains an error code, human-readable message, and details.
Show Source
-
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
Nested Schema : result
Type:
objectGeneric result for all request entity types. The type returned depends on endpoint. May be ExecutionLog, list, or error data.
Examples
401 Response
Unauthorized : User lacks access.
Root Schema : BaseResponse
Type:
objectBase response object for all reporting service endpoints, providing a standard structure for status, result, and errorData.
Show Source
-
errorData: object
ErrorResponseData
Structure representing an error response from the reporting service. Contains an error code, human-readable message, and details.
-
result: object
result
Generic result for all request entity types. The type returned depends on endpoint. May be ExecutionLog, list, or error data.
-
status: string
Response status for the request; typically 'success' or 'error'.Example:
success
Nested Schema : ErrorResponseData
Type:
objectStructure representing an error response from the reporting service. Contains an error code, human-readable message, and details.
Show Source
-
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
Nested Schema : result
Type:
objectGeneric result for all request entity types. The type returned depends on endpoint. May be ExecutionLog, list, or error data.
Examples
500 Response
Internal Server Error : Unexpected server failure.
Root Schema : BaseResponse
Type:
objectBase response object for all reporting service endpoints, providing a standard structure for status, result, and errorData.
Show Source
-
errorData: object
ErrorResponseData
Structure representing an error response from the reporting service. Contains an error code, human-readable message, and details.
-
result: object
result
Generic result for all request entity types. The type returned depends on endpoint. May be ExecutionLog, list, or error data.
-
status: string
Response status for the request; typically 'success' or 'error'.Example:
success
Nested Schema : ErrorResponseData
Type:
objectStructure representing an error response from the reporting service. Contains an error code, human-readable message, and details.
Show Source
-
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
Nested Schema : result
Type:
objectGeneric result for all request entity types. The type returned depends on endpoint. May be ExecutionLog, list, or error data.
Examples