Skip to content

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

/srv.asmx/GetRandDSchedules

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

<root success="true">
  <RetentionAndDispositionSchedules />
</root>

Error Response

<root success="false" error="[901]Session expired or Invalid ticket" />

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.

Error Codes

Error Description
[900] Authentication failed -" invalid credentials.
[901] Session expired or invalid authentication ticket.