V1.0
get
/ec-dataaction-svc/rest/v1.0/studies/{studyId}/{mode}/signinfo
Get paginated sign configuration eligibility records. Returns a list of eligibility information for forms and visits, filtered by study, site, subject, event, and more.
Request
Path Parameters
-
mode(required): string
Mode of the study, accepts: test, active, or training.Example:
test -
studyId(required): string(uuid)
Unique identifier (UUID, 32-character uppercase hexadecimal string) representing the study.Example:
7C9436942A714E20BB5C2E711FBC1D4B
Query Parameters
-
eventId: string(uuid)
Unique identifier(UUID, 32-character uppercase hexadecimal string) representing the clinical event like Screening, Visit 1 etc.Example:
D27DB9E0AFE349D7980683CF55A33883 -
eventInstanceNum: string(uuid)
Numeric value representing the instance number of the event. Used for repeated or unscheduled visits. It is null for scheduled events.Example:
1 -
limit: integer(int32)
Minimum Value:
0Maximum number of records to display per page.Example:10 -
offset: integer(int32)
Minimum Value:
0An order number to specify with which object you want to start retrieving result. If provided, you also need to specify a value for the limit parameter.Example:0 -
signStatus: string
Sign eligibility status filter Values can signed, readyToSign.Example:
signed -
siteIds: array[string]
Unique identifier (UUID, 32-character uppercase hexadecimal string) representing the clinical site.Example:
[ "1BC29B36F5D64B1B95F4BDBBCEA481BE" ] -
subjectId: string(uuid)
Unique subject identifier (UUID, 32-character uppercase hexadecimal string) representing the patient/participant enrolled in the study.Example:
D27DB9E0AFE349D7980683CF55A33883
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
200 Response
Success
Root Schema : schema
Type:
Show Source
array-
Array of:
object SignConfigEligibilityResponseDTO
containing detailed sign configuration eligibility information for a subject, form, and visit.
Nested Schema : SignConfigEligibilityResponseDTO
Type:
objectcontaining detailed sign configuration eligibility information for a subject, form, and visit.
Show Source
-
actionStatus: string
Current action status for the eligibility can view, sign.Example:
view -
affidavitCodeValue: string
Code value for the affidavit if applicable.Example:
Electronic Signature Affidavit -
comment: string
Administrative comment regarding eligibility.Example:
Included after manual review. -
configId: string
Signature configuration identifier (UUID, 32-character uppercase hexadecimal string).Example:
4E005942732C417D9B47C6ACBB3ACD65 -
dueDays: integer
(int32)
Number of days the action is due.Example:
3 -
eventId: string
Unique identifier(UUID, 32-character uppercase hexadecimal string) representing the clinical event like Screening, Visit 1 etc.Example:
D27DB9E0AFE349D7980683CF55A33883 -
eventInstanceNum: integer
(int32)
Numeric value representing the instance number of the event. Used for repeated or unscheduled visits. It is null for scheduled events.Example:
1 -
formId: string
Unique identifier(UUID, 32-character uppercase hexadecimal string) representing the clinical form.Example:
360E6122F84A43CAAF70E3BECC471A7C -
formSectionId: string
ID (UUID, 32-character uppercase hexadecimal string) of the form section.Example:
4FB2D38F8F9644D2B3BE08B815A8FF1A -
formTitle: string
Title of the associated form.Example:
Informed Consent -
id: string
Unique identifier(UUID, 32-character uppercase hexadecimal string) for the sign config eligibility recordExample:
4F3A7FD6A91E4A5FAB1EA98387E82B6B -
innerRepeat: integer
(int32)
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 -
objectVersionNumber: number
(integer)
Object version numberExample:
1 -
operationType: string
Operation type on the record, can have values CREATED, MODIFIED or REMOVEDExample:
CREATED -
outerRepeat: integer
(int32)
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:
2 -
reason: string
The reason for the current change.Example:
Other. -
repeatFormNumber: integer
(int32)
Form repeat number if applicable.Example:
2 -
repeatSequenceNumber: integer
(int32)
Indicates the order of occurrence for a repeating form instance, used to distinguish between multiple repetitions of the same form.Example:
1 -
requiredBy: array
requiredBy
List of String of UUID(UUID, 32-character uppercase hexadecimal string) of user id roles or entities that require the eligibility.
-
requiredOn: string
Indicates what element the eligibility is required on SUBJECT, FORM, CASEBOOK.Example:
FORM -
siteId: string
Unique identifier (UUID, 32-character uppercase hexadecimal string) representing the clinical site.Example:
1BC29B36F5D64B1B95F4BDBBCEA481BE -
softwareVersionNumber: number
(integer)
Software version numberExample:
3 -
status: string
Status associated with the eligibility and values can be readyToSign, signedExample:
readyToSign -
studyVersion: string
String representing the version of the study configuration or protocol. Helps track changes in form or study design.Example:
1.0.0.0 -
subjectId: string
Unique subject identifier (UUID, 32-character uppercase hexadecimal string) representing the patient/participant enrolled in the study.Example:
AABBCCDDEEFF00112233445566778899 -
subjectNumber: string
Unique number representing subject within the study.Example:
SUBJ1067 -
userId: string
Unique Identifier (UUID, 32-character uppercase hexadecimal string) of the userExample:
9AAECDD92E3F41C6AFD2B8FF1DD9CF22 -
versionEnd: string
(date-time)
The end date until which the data is applicable or valid.Example:
2023-08-10T00:00:00Z -
versionStart: string
The timestamp marking the beginning of the validity period for this record version within the system.Example:
2023-08-10T00:00:00.000Z -
visitTitle: string
Title of the associated clinical visit.Example:
Visit 1
Nested Schema : requiredBy
Type:
arrayList of String of UUID(UUID, 32-character uppercase hexadecimal string) of user id roles or entities that require the eligibility.
Show Source
-
Array of:
string
List of String of UUID(UUID, 32-character uppercase hexadecimal string) of user id roles or entities that require the eligibility.Example:
["A1B23C45D67E89F123456789ABCDEF12","B2C34D56E78F90A123456789ABCDEF34"]
Example:
[
"A1B23C45D67E89F123456789ABCDEF12",
"B2C34D56E78F90A123456789ABCDEF34"
]Examples
400 Response
Bad_Request
Root Schema : RestResponse
Type:
Show Source
object-
errorData: object
ErrorResponseData
Structure representing an error response from the reporting service. Contains an error code, human-readable message, and details.
-
result: object
result
-
status: string
-
version: integer
(int32)
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: object
details
Detailed error context or debugging information such as validation error, stack trace, or field/parameter cause.
-
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:
objectNested Schema : details
Type:
objectDetailed 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