Retrieve a Specific Agreement

Last modified on August 24, 2023 at 6:51 pm


Retrieve a specific agreement by specifying the agreement type. At this time, the possible types are standard and custom. The JSON-encoded response object will contain the agreement. The Object Definition is provided below.

JSON Object Definition

The following lists properties on the JSON object representing agreements you may encounter when retrieving an agreement. Fields with no value set are omitted from the JSON object. For a complete list of agreement properties and further details, see the Agreement Object Reference.

  "type": "",
  "title": "",
  "text": "",
  "createdDate": "",
  "updatedDate": "",
  "required": false


This example shows a response containing the organization-specific custom agreement. The custom agreement type is always required if it is defined, so the required property is true.

GET /dc/api/v5/agreements/custom HTTP/1.1
Accept: application/json
HTTP/1.1 200 OK
Content-type: application/json
Content-length: 931

  "type": "custom",
  "title": "Organizational Guidelines for Educational Materials",
  "text": "The materials you access through DigitalChalk as part of the courses have been approved by the relevant international regulatory bodies. By accessing these materials, you acknowledge that the materials are covered under international copyright laws, and you agree to use the materials only in a way that is consistent with the parameters of the course.",
  "createdDate": "2012-12-06T22:07:18Z",
  "updatedDate": "2012-12-09T17:18:02Z",
  "required": true