GetRandDSchedules API¶
Returns a summary list of all Retention and Disposition (R&D) schedule definitions defined in the system. For full details on a specific schedule, use GetRandDScheduleInfo.
Endpoint¶
Methods¶
- GET
/srv.asmx/GetRandDSchedules?authenticationTicket=... - POST
/srv.asmx/GetRandDSchedules(form data) - SOAP Action:
http://tempuri.org/GetRandDSchedules
Parameters¶
| Parameter | Type | Required | Description |
|---|---|---|---|
authenticationTicket |
string | Yes | Authentication ticket obtained from AuthenticateUser. |
Response¶
Success Response¶
<root success="true">
<RetentionAndDispositionSchedules>
<RetentionAndDispositionSchedule
RDDefID="47"
RDName="Standard 7-Year Retention"
Description="Retain documents for 7 years then destroy"
RetentionType="1"
RetentionTypeText="Fixed Date"
DispositionType="2"
DispositionTypeText="Destroy" />
<RetentionAndDispositionSchedule
RDDefID="48"
RDName="Permanent Legal Hold"
Description="Permanent retention for legal documents"
RetentionType="3"
RetentionTypeText="Permanent"
DispositionType="0"
DispositionTypeText="None" />
</RetentionAndDispositionSchedules>
</root>
No Schedules Defined¶
Error Response¶
Response Structure¶
<RetentionAndDispositionSchedules>¶
Container element for all schedule summaries.
<RetentionAndDispositionSchedule>¶
| Attribute | Description |
|---|---|
RDDefID |
Numeric ID of the schedule definition. Use this value in other R&D APIs. |
RDName |
Schedule name. |
Description |
Schedule description. |
RetentionType |
Numeric code for the retention type. |
RetentionTypeText |
Human-readable label for the retention type (localized). |
DispositionType |
Numeric code for the disposition type. |
DispositionTypeText |
Human-readable label for the disposition type (localized). |
Required Permissions¶
Any authenticated user. Anonymous access is not allowed.
Example¶
GET Request¶
GET /srv.asmx/GetRandDSchedules
?authenticationTicket=3f7a1b2c-4d5e-6f7a-8b9c-0d1e2f3a4b5c
HTTP/1.1
Host: yourserver
POST Request¶
POST /srv.asmx/GetRandDSchedules HTTP/1.1
Host: yourserver
Content-Type: application/x-www-form-urlencoded
authenticationTicket=3f7a1b2c-4d5e-6f7a-8b9c-0d1e2f3a4b5c
Notes¶
- Returns a summary list of all schedules including retention and disposition type codes and their localized text labels. For the complete definition with all settings and audit information, call GetRandDScheduleInfo with the
RDDefID. - All schedules in the system are returned regardless of assignment status.
Related APIs¶
- GetRandDScheduleInfo -" Get full details of a specific schedule.
- CreateRandDSchedule -" Create a new R&D schedule definition.
- UpdateRandDSchedule -" Update an existing schedule definition.
- DeleteRandDSchedule -" Delete a schedule definition.
- SetDocumentRandDSchedule -" Assign a schedule to a document.
- SetFolderRandDSchedule -" Assign a schedule to a folder.
Error Codes¶
| Error | Description |
|---|---|
[900] |
Authentication failed -" invalid credentials. |
[901] |
Session expired or invalid authentication ticket. |