Consent Model

Each consent record in ConsentGrid™ represents data subjects' consent to the acivity represented by a SmartConsent. Because of this, each consent record has a value associated with it. The value is true if the data subjects accept, and false if they reject.

Usually each consent record has one owner who is the data subject agreed or rejected the activity. However, it is possible to define multi-party consents with ConsentGrid™, and because of this, the model has owners field which is an array.

Consent records are versioned. Any updates performed on the consent (either by the data subject, administrator, or automatically by ConsentGrid&trade) creates a new version of the consent record while preserving the old version in an archive.

A typical consent record looks like the following:

  "id": "5e966c164d9cd851c5d9a4b3.VkTQIiWpR8eCABDhEe5UrQ",
  "uri": "",
  "version": 2,
  "owners": [{
    "subject": {
      "type": "user"
  "timestamp": "2019-11-10T23:00:00Z",
  "status": "active",
  "consent": "terms",
  "value": true,
  "scopes": [],
  "choices": {
    "expirationDate": "2020-11-20T23:00:00Z"
  "policy": {
    "url": "https://...",
    "version": 2
  "form": {
    "name": "terms",
    "locale": "en",
    "version": 4

policy object contains a reference to the terms related to this consent record. This is set by the caller application to the policy used to capture this consent. If the consent is created using an online form, form object gives the name, locale, and the version of the form used to capture consent.