docspring 3.3.0 → 4.0.0

package/dist/model/{SubmissionDataRequestShow.js → SignatureRequest.js}

@@ -5,6 +5,9 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports["default"] = void 0;
 var _ApiClient = _interopRequireDefault(require("../ApiClient"));
+var _SignatureRequestAuthSecondFactorType = _interopRequireDefault(require("./SignatureRequestAuthSecondFactorType"));
+var _SignatureRequestAuthType = _interopRequireDefault(require("./SignatureRequestAuthType"));
+var _SignatureRequestState = _interopRequireDefault(require("./SignatureRequestState"));
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { "default": e }; }
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
 function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
@@ -16,9 +19,9 @@ function _createClass(e, r, t) { return r && _defineProperties(e.prototype, r),
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
 function _toPrimitive(t, e) { if ("object" != _typeof(t) || !t) return t; var r; if ("undefined" != typeof Symbol && void 0 !== (r = t[Symbol.toPrimitive])) { var i = r.call(t, e || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === e ? String : Number)(t); } /**
  * DocSpring API
- * Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures. Requests are rate limited per account, and live PDFs use credits: a request over the limit returns 429 with a Retry-After header, and one your credits can't cover returns 402. See [Credits & Rate Limits](https://docspring.com/docs/api-guide/credits-and-rate-limits/).
+ * Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures.
  *
- * The version of the OpenAPI document: v1
+ * The version of the OpenAPI document: v2
  * 
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -27,42 +30,45 @@ function _toPrimitive(t, e) { if ("object" != _typeof(t) || !t) return t; var r;
  *
  */
 /**
- * The SubmissionDataRequestShow model module.
- * @module model/SubmissionDataRequestShow
- * @version 3.3.0
+ * The SignatureRequest model module.
+ * @module model/SignatureRequest
+ * @version 4.0.0
  */
-var SubmissionDataRequestShow = /*#__PURE__*/function () {
+var SignatureRequest = /*#__PURE__*/function () {
   /**
-   * Constructs a new <code>SubmissionDataRequestShow</code>.
-   * @alias module:model/SubmissionDataRequestShow
+   * Constructs a new <code>SignatureRequest</code>.
+   * A request for someone to fill in their fields of a submission and sign it. Someone who only fills in fields for the people who sign later (such as an employer's section) has a signature request too. The submission's PDF is generated once every signature request is completed.
+   * @alias module:model/SignatureRequest
    * @extends Object
-   * @param id {String} 
-   * @param email {String} 
-   * @param name {String} 
-   * @param order {Number} 
-   * @param sort_order {Number} 
-   * @param fields {Array.<String>} 
-   * @param metadata {Object} 
-   * @param state {module:model/SubmissionDataRequestShow.StateEnum} 
-   * @param viewed_at {String} 
-   * @param completed_at {String} 
-   * @param declined_at {String} 
-   * @param data {Object} 
-   * @param auth_type {module:model/SubmissionDataRequestShow.AuthTypeEnum} 
-   * @param auth_second_factor_type {module:model/SubmissionDataRequestShow.AuthSecondFactorTypeEnum} 
-   * @param auth_provider {String} 
-   * @param auth_session_started_at {String} 
-   * @param auth_session_id_hash {String} 
-   * @param auth_user_id_hash {String} 
-   * @param auth_username_hash {String} 
-   * @param auth_phone_number_hash {String} 
-   * @param ip_address {String} 
-   * @param user_agent {String} 
-   * @param submission_id {String} 
+   * @param id {String} The signature request's ID.
+   * @param submission_id {String} The ID of the submission the signature request belongs to.
+   * @param name {String} The name of the person the request is for.
+   * @param email {String} Their email address.
+   * @param fields {Array.<String>} The fields this person fills in. Null for a signature request created with API v1 without a field list: it asks for every field the submission's data doesn't have.
+   * @param metadata {Object.<String, Object>} Your own data about the signature request, such as an ID from your app.
+   * @param role {String} Which of the template's signers the person is. Until templates have roles of their own, a template's signers are `Signer 1`, `Signer 2` and so on, up to `Signer 100`: `Signer 1` is the one whose details the template's `@@signature_requests/0` fields print.
+   * @param sort_order {Number} The signer's position, from 0: `Signer 1` is 0. The template's `@@signature_requests/<sort_order>` fields print this signature request's details.
+   * @param state {module:model/SignatureRequestState} `pending` until the person completes the signature request (`completed`) or declines it (`declined`).
+   * @param data {Object.<String, Object>} The values this person entered for their own fields (`fields`). Null when their submission's data is left out: in lists without `include_data=true`, in the events of a webhook that leaves out submission data, and once the submission has expired.
+   * @param viewed_at {Date} When the person first opened the signature request.
+   * @param completed_at {Date} When they completed it.
+   * @param declined_at {Date} When they declined it.
+   * @param auth_type {module:model/SignatureRequestAuthType} How your app authenticated the person before it showed them the signature request.
+   * @param auth_second_factor_type {module:model/SignatureRequestAuthSecondFactorType} The second factor your app authenticated them with, if any.
+   * @param auth_provider {String} The service that authenticated them, such as `google`. Required when `auth_type` is `oauth`.
+   * @param auth_session_started_at {Date} When your app authenticated them. Set for you with `email_link`.
+   * @param auth_session_id_hash {String} A hash of your app's session ID, for the audit trail.
+   * @param auth_user_id_hash {String} Their user ID in your app, or a SHA-256 hash of a salt and the user ID.
+   * @param auth_username_hash {String} Their username in your app, or a SHA-256 hash of a salt and the username.
+   * @param auth_phone_number_hash {String} The phone number they authenticated with, or a SHA-256 hash of a salt and the phone number.
+   * @param ip_address {String} The IP address they completed the signature request from. Null in the events of a webhook that leaves out submission data.
+   * @param user_agent {String} The User-Agent header of the browser they completed the signature request with. Null in the events of a webhook that leaves out submission data.
+   * @param created_at {Date} When the signature request was created.
+   * @param updated_at {Date} When the signature request was last updated.
    */
-  function SubmissionDataRequestShow(id, email, name, order, sort_order, fields, metadata, state, viewed_at, completed_at, declined_at, data, auth_type, auth_second_factor_type, auth_provider, auth_session_started_at, auth_session_id_hash, auth_user_id_hash, auth_username_hash, auth_phone_number_hash, ip_address, user_agent, submission_id) {
-    _classCallCheck(this, SubmissionDataRequestShow);
-    SubmissionDataRequestShow.initialize(this, id, email, name, order, sort_order, fields, metadata, state, viewed_at, completed_at, declined_at, data, auth_type, auth_second_factor_type, auth_provider, auth_session_started_at, auth_session_id_hash, auth_user_id_hash, auth_username_hash, auth_phone_number_hash, ip_address, user_agent, submission_id);
+  function SignatureRequest(id, submission_id, name, email, fields, metadata, role, sort_order, state, data, viewed_at, completed_at, declined_at, auth_type, auth_second_factor_type, auth_provider, auth_session_started_at, auth_session_id_hash, auth_user_id_hash, auth_username_hash, auth_phone_number_hash, ip_address, user_agent, created_at, updated_at) {
+    _classCallCheck(this, SignatureRequest);
+    SignatureRequest.initialize(this, id, submission_id, name, email, fields, metadata, role, sort_order, state, data, viewed_at, completed_at, declined_at, auth_type, auth_second_factor_type, auth_provider, auth_session_started_at, auth_session_id_hash, auth_user_id_hash, auth_username_hash, auth_phone_number_hash, ip_address, user_agent, created_at, updated_at);
   }
 
   /**
@@ -70,21 +76,22 @@ var SubmissionDataRequestShow = /*#__PURE__*/function () {
    * This method is used by the constructors of any subclasses, in order to implement multiple inheritance (mix-ins).
    * Only for internal use.
    */
-  return _createClass(SubmissionDataRequestShow, null, [{
+  return _createClass(SignatureRequest, null, [{
     key: "initialize",
-    value: function initialize(obj, id, email, name, order, sort_order, fields, metadata, state, viewed_at, completed_at, declined_at, data, auth_type, auth_second_factor_type, auth_provider, auth_session_started_at, auth_session_id_hash, auth_user_id_hash, auth_username_hash, auth_phone_number_hash, ip_address, user_agent, submission_id) {
+    value: function initialize(obj, id, submission_id, name, email, fields, metadata, role, sort_order, state, data, viewed_at, completed_at, declined_at, auth_type, auth_second_factor_type, auth_provider, auth_session_started_at, auth_session_id_hash, auth_user_id_hash, auth_username_hash, auth_phone_number_hash, ip_address, user_agent, created_at, updated_at) {
       obj['id'] = id;
-      obj['email'] = email;
+      obj['submission_id'] = submission_id;
       obj['name'] = name;
-      obj['order'] = order;
-      obj['sort_order'] = sort_order;
+      obj['email'] = email;
       obj['fields'] = fields;
       obj['metadata'] = metadata;
+      obj['role'] = role;
+      obj['sort_order'] = sort_order;
       obj['state'] = state;
+      obj['data'] = data;
       obj['viewed_at'] = viewed_at;
       obj['completed_at'] = completed_at;
       obj['declined_at'] = declined_at;
-      obj['data'] = data;
       obj['auth_type'] = auth_type;
       obj['auth_second_factor_type'] = auth_second_factor_type;
       obj['auth_provider'] = auth_provider;
@@ -95,69 +102,77 @@ var SubmissionDataRequestShow = /*#__PURE__*/function () {
       obj['auth_phone_number_hash'] = auth_phone_number_hash;
       obj['ip_address'] = ip_address;
       obj['user_agent'] = user_agent;
-      obj['submission_id'] = submission_id;
+      obj['created_at'] = created_at;
+      obj['updated_at'] = updated_at;
     }
 
     /**
-     * Constructs a <code>SubmissionDataRequestShow</code> from a plain JavaScript object, optionally creating a new instance.
+     * Constructs a <code>SignatureRequest</code> from a plain JavaScript object, optionally creating a new instance.
      * Copies all relevant properties from <code>data</code> to <code>obj</code> if supplied or a new instance if not.
      * @param {Object} data The plain JavaScript object bearing properties of interest.
-     * @param {module:model/SubmissionDataRequestShow} obj Optional instance to populate.
-     * @return {module:model/SubmissionDataRequestShow} The populated <code>SubmissionDataRequestShow</code> instance.
+     * @param {module:model/SignatureRequest} obj Optional instance to populate.
+     * @return {module:model/SignatureRequest} The populated <code>SignatureRequest</code> instance.
      */
   }, {
     key: "constructFromObject",
     value: function constructFromObject(data, obj) {
       if (data) {
-        obj = obj || new SubmissionDataRequestShow();
+        obj = obj || new SignatureRequest();
         _ApiClient["default"].constructFromObject(data, obj, 'Object');
         if (data.hasOwnProperty('id')) {
           obj['id'] = _ApiClient["default"].convertToType(data['id'], 'String');
         }
-        if (data.hasOwnProperty('email')) {
-          obj['email'] = _ApiClient["default"].convertToType(data['email'], 'String');
+        if (data.hasOwnProperty('submission_id')) {
+          obj['submission_id'] = _ApiClient["default"].convertToType(data['submission_id'], 'String');
         }
         if (data.hasOwnProperty('name')) {
           obj['name'] = _ApiClient["default"].convertToType(data['name'], 'String');
         }
-        if (data.hasOwnProperty('order')) {
-          obj['order'] = _ApiClient["default"].convertToType(data['order'], 'Number');
-        }
-        if (data.hasOwnProperty('sort_order')) {
-          obj['sort_order'] = _ApiClient["default"].convertToType(data['sort_order'], 'Number');
+        if (data.hasOwnProperty('email')) {
+          obj['email'] = _ApiClient["default"].convertToType(data['email'], 'String');
         }
         if (data.hasOwnProperty('fields')) {
           obj['fields'] = _ApiClient["default"].convertToType(data['fields'], ['String']);
         }
         if (data.hasOwnProperty('metadata')) {
-          obj['metadata'] = _ApiClient["default"].convertToType(data['metadata'], Object);
+          obj['metadata'] = _ApiClient["default"].convertToType(data['metadata'], {
+            'String': Object
+          });
+        }
+        if (data.hasOwnProperty('role')) {
+          obj['role'] = _ApiClient["default"].convertToType(data['role'], 'String');
+        }
+        if (data.hasOwnProperty('sort_order')) {
+          obj['sort_order'] = _ApiClient["default"].convertToType(data['sort_order'], 'Number');
         }
         if (data.hasOwnProperty('state')) {
-          obj['state'] = _ApiClient["default"].convertToType(data['state'], 'String');
+          obj['state'] = _ApiClient["default"].convertToType(data['state'], _SignatureRequestState["default"]);
+        }
+        if (data.hasOwnProperty('data')) {
+          obj['data'] = _ApiClient["default"].convertToType(data['data'], {
+            'String': Object
+          });
         }
         if (data.hasOwnProperty('viewed_at')) {
-          obj['viewed_at'] = _ApiClient["default"].convertToType(data['viewed_at'], 'String');
+          obj['viewed_at'] = _ApiClient["default"].convertToType(data['viewed_at'], 'Date');
         }
         if (data.hasOwnProperty('completed_at')) {
-          obj['completed_at'] = _ApiClient["default"].convertToType(data['completed_at'], 'String');
+          obj['completed_at'] = _ApiClient["default"].convertToType(data['completed_at'], 'Date');
         }
         if (data.hasOwnProperty('declined_at')) {
-          obj['declined_at'] = _ApiClient["default"].convertToType(data['declined_at'], 'String');
-        }
-        if (data.hasOwnProperty('data')) {
-          obj['data'] = _ApiClient["default"].convertToType(data['data'], Object);
+          obj['declined_at'] = _ApiClient["default"].convertToType(data['declined_at'], 'Date');
         }
         if (data.hasOwnProperty('auth_type')) {
-          obj['auth_type'] = _ApiClient["default"].convertToType(data['auth_type'], 'String');
+          obj['auth_type'] = _ApiClient["default"].convertToType(data['auth_type'], _SignatureRequestAuthType["default"]);
         }
         if (data.hasOwnProperty('auth_second_factor_type')) {
-          obj['auth_second_factor_type'] = _ApiClient["default"].convertToType(data['auth_second_factor_type'], 'String');
+          obj['auth_second_factor_type'] = _ApiClient["default"].convertToType(data['auth_second_factor_type'], _SignatureRequestAuthSecondFactorType["default"]);
         }
         if (data.hasOwnProperty('auth_provider')) {
           obj['auth_provider'] = _ApiClient["default"].convertToType(data['auth_provider'], 'String');
         }
         if (data.hasOwnProperty('auth_session_started_at')) {
-          obj['auth_session_started_at'] = _ApiClient["default"].convertToType(data['auth_session_started_at'], 'String');
+          obj['auth_session_started_at'] = _ApiClient["default"].convertToType(data['auth_session_started_at'], 'Date');
         }
         if (data.hasOwnProperty('auth_session_id_hash')) {
           obj['auth_session_id_hash'] = _ApiClient["default"].convertToType(data['auth_session_id_hash'], 'String');
@@ -177,23 +192,26 @@ var SubmissionDataRequestShow = /*#__PURE__*/function () {
         if (data.hasOwnProperty('user_agent')) {
           obj['user_agent'] = _ApiClient["default"].convertToType(data['user_agent'], 'String');
         }
-        if (data.hasOwnProperty('submission_id')) {
-          obj['submission_id'] = _ApiClient["default"].convertToType(data['submission_id'], 'String');
+        if (data.hasOwnProperty('created_at')) {
+          obj['created_at'] = _ApiClient["default"].convertToType(data['created_at'], 'Date');
+        }
+        if (data.hasOwnProperty('updated_at')) {
+          obj['updated_at'] = _ApiClient["default"].convertToType(data['updated_at'], 'Date');
         }
       }
       return obj;
     }
 
     /**
-     * Validates the JSON data with respect to <code>SubmissionDataRequestShow</code>.
+     * Validates the JSON data with respect to <code>SignatureRequest</code>.
      * @param {Object} data The plain JavaScript object bearing properties of interest.
-     * @return {boolean} to indicate whether the JSON data is valid with respect to <code>SubmissionDataRequestShow</code>.
+     * @return {boolean} to indicate whether the JSON data is valid with respect to <code>SignatureRequest</code>.
      */
   }, {
     key: "validateJSON",
     value: function validateJSON(data) {
       // check to make sure all required properties are present in the JSON string
-      var _iterator = _createForOfIteratorHelper(SubmissionDataRequestShow.RequiredProperties),
+      var _iterator = _createForOfIteratorHelper(SignatureRequest.RequiredProperties),
         _step;
       try {
         for (_iterator.s(); !(_step = _iterator.n()).done;) {
@@ -212,50 +230,30 @@ var SubmissionDataRequestShow = /*#__PURE__*/function () {
         throw new Error("Expected the field `id` to be a primitive type in the JSON string but got " + data['id']);
       }
       // ensure the json data is a string
-      if (data['email'] && !(typeof data['email'] === 'string' || data['email'] instanceof String)) {
-        throw new Error("Expected the field `email` to be a primitive type in the JSON string but got " + data['email']);
+      if (data['submission_id'] && !(typeof data['submission_id'] === 'string' || data['submission_id'] instanceof String)) {
+        throw new Error("Expected the field `submission_id` to be a primitive type in the JSON string but got " + data['submission_id']);
       }
       // ensure the json data is a string
       if (data['name'] && !(typeof data['name'] === 'string' || data['name'] instanceof String)) {
         throw new Error("Expected the field `name` to be a primitive type in the JSON string but got " + data['name']);
       }
+      // ensure the json data is a string
+      if (data['email'] && !(typeof data['email'] === 'string' || data['email'] instanceof String)) {
+        throw new Error("Expected the field `email` to be a primitive type in the JSON string but got " + data['email']);
+      }
       // ensure the json data is an array
       if (!Array.isArray(data['fields'])) {
         throw new Error("Expected the field `fields` to be an array in the JSON data but got " + data['fields']);
       }
       // ensure the json data is a string
-      if (data['state'] && !(typeof data['state'] === 'string' || data['state'] instanceof String)) {
-        throw new Error("Expected the field `state` to be a primitive type in the JSON string but got " + data['state']);
-      }
-      // ensure the json data is a string
-      if (data['viewed_at'] && !(typeof data['viewed_at'] === 'string' || data['viewed_at'] instanceof String)) {
-        throw new Error("Expected the field `viewed_at` to be a primitive type in the JSON string but got " + data['viewed_at']);
-      }
-      // ensure the json data is a string
-      if (data['completed_at'] && !(typeof data['completed_at'] === 'string' || data['completed_at'] instanceof String)) {
-        throw new Error("Expected the field `completed_at` to be a primitive type in the JSON string but got " + data['completed_at']);
-      }
-      // ensure the json data is a string
-      if (data['declined_at'] && !(typeof data['declined_at'] === 'string' || data['declined_at'] instanceof String)) {
-        throw new Error("Expected the field `declined_at` to be a primitive type in the JSON string but got " + data['declined_at']);
-      }
-      // ensure the json data is a string
-      if (data['auth_type'] && !(typeof data['auth_type'] === 'string' || data['auth_type'] instanceof String)) {
-        throw new Error("Expected the field `auth_type` to be a primitive type in the JSON string but got " + data['auth_type']);
-      }
-      // ensure the json data is a string
-      if (data['auth_second_factor_type'] && !(typeof data['auth_second_factor_type'] === 'string' || data['auth_second_factor_type'] instanceof String)) {
-        throw new Error("Expected the field `auth_second_factor_type` to be a primitive type in the JSON string but got " + data['auth_second_factor_type']);
+      if (data['role'] && !(typeof data['role'] === 'string' || data['role'] instanceof String)) {
+        throw new Error("Expected the field `role` to be a primitive type in the JSON string but got " + data['role']);
       }
       // ensure the json data is a string
       if (data['auth_provider'] && !(typeof data['auth_provider'] === 'string' || data['auth_provider'] instanceof String)) {
         throw new Error("Expected the field `auth_provider` to be a primitive type in the JSON string but got " + data['auth_provider']);
       }
       // ensure the json data is a string
-      if (data['auth_session_started_at'] && !(typeof data['auth_session_started_at'] === 'string' || data['auth_session_started_at'] instanceof String)) {
-        throw new Error("Expected the field `auth_session_started_at` to be a primitive type in the JSON string but got " + data['auth_session_started_at']);
-      }
-      // ensure the json data is a string
       if (data['auth_session_id_hash'] && !(typeof data['auth_session_id_hash'] === 'string' || data['auth_session_id_hash'] instanceof String)) {
         throw new Error("Expected the field `auth_session_id_hash` to be a primitive type in the JSON string but got " + data['auth_session_id_hash']);
       }
@@ -279,232 +277,159 @@ var SubmissionDataRequestShow = /*#__PURE__*/function () {
       if (data['user_agent'] && !(typeof data['user_agent'] === 'string' || data['user_agent'] instanceof String)) {
         throw new Error("Expected the field `user_agent` to be a primitive type in the JSON string but got " + data['user_agent']);
       }
-      // ensure the json data is a string
-      if (data['submission_id'] && !(typeof data['submission_id'] === 'string' || data['submission_id'] instanceof String)) {
-        throw new Error("Expected the field `submission_id` to be a primitive type in the JSON string but got " + data['submission_id']);
-      }
       return true;
     }
   }]);
 }();
-SubmissionDataRequestShow.RequiredProperties = ["id", "email", "name", "order", "sort_order", "fields", "metadata", "state", "viewed_at", "completed_at", "declined_at", "data", "auth_type", "auth_second_factor_type", "auth_provider", "auth_session_started_at", "auth_session_id_hash", "auth_user_id_hash", "auth_username_hash", "auth_phone_number_hash", "ip_address", "user_agent", "submission_id"];
+SignatureRequest.RequiredProperties = ["id", "submission_id", "name", "email", "fields", "metadata", "role", "sort_order", "state", "data", "viewed_at", "completed_at", "declined_at", "auth_type", "auth_second_factor_type", "auth_provider", "auth_session_started_at", "auth_session_id_hash", "auth_user_id_hash", "auth_username_hash", "auth_phone_number_hash", "ip_address", "user_agent", "created_at", "updated_at"];
 
 /**
+ * The signature request's ID.
  * @member {String} id
  */
-SubmissionDataRequestShow.prototype['id'] = undefined;
+SignatureRequest.prototype['id'] = undefined;
 
 /**
- * @member {String} email
+ * The ID of the submission the signature request belongs to.
+ * @member {String} submission_id
  */
-SubmissionDataRequestShow.prototype['email'] = undefined;
+SignatureRequest.prototype['submission_id'] = undefined;
 
 /**
+ * The name of the person the request is for.
  * @member {String} name
  */
-SubmissionDataRequestShow.prototype['name'] = undefined;
+SignatureRequest.prototype['name'] = undefined;
 
 /**
- * @member {Number} order
+ * Their email address.
+ * @member {String} email
  */
-SubmissionDataRequestShow.prototype['order'] = undefined;
+SignatureRequest.prototype['email'] = undefined;
 
 /**
- * @member {Number} sort_order
+ * The fields this person fills in. Null for a signature request created with API v1 without a field list: it asks for every field the submission's data doesn't have.
+ * @member {Array.<String>} fields
  */
-SubmissionDataRequestShow.prototype['sort_order'] = undefined;
+SignatureRequest.prototype['fields'] = undefined;
 
 /**
- * @member {Array.<String>} fields
+ * Your own data about the signature request, such as an ID from your app.
+ * @member {Object.<String, Object>} metadata
  */
-SubmissionDataRequestShow.prototype['fields'] = undefined;
+SignatureRequest.prototype['metadata'] = undefined;
 
 /**
- * @member {Object} metadata
+ * Which of the template's signers the person is. Until templates have roles of their own, a template's signers are `Signer 1`, `Signer 2` and so on, up to `Signer 100`: `Signer 1` is the one whose details the template's `@@signature_requests/0` fields print.
+ * @member {String} role
  */
-SubmissionDataRequestShow.prototype['metadata'] = undefined;
+SignatureRequest.prototype['role'] = undefined;
 
 /**
- * @member {module:model/SubmissionDataRequestShow.StateEnum} state
+ * The signer's position, from 0: `Signer 1` is 0. The template's `@@signature_requests/<sort_order>` fields print this signature request's details.
+ * @member {Number} sort_order
+ */
+SignatureRequest.prototype['sort_order'] = undefined;
+
+/**
+ * `pending` until the person completes the signature request (`completed`) or declines it (`declined`).
+ * @member {module:model/SignatureRequestState} state
  */
-SubmissionDataRequestShow.prototype['state'] = undefined;
+SignatureRequest.prototype['state'] = undefined;
 
 /**
- * @member {String} viewed_at
+ * The values this person entered for their own fields (`fields`). Null when their submission's data is left out: in lists without `include_data=true`, in the events of a webhook that leaves out submission data, and once the submission has expired.
+ * @member {Object.<String, Object>} data
  */
-SubmissionDataRequestShow.prototype['viewed_at'] = undefined;
+SignatureRequest.prototype['data'] = undefined;
 
 /**
- * @member {String} completed_at
+ * When the person first opened the signature request.
+ * @member {Date} viewed_at
  */
-SubmissionDataRequestShow.prototype['completed_at'] = undefined;
+SignatureRequest.prototype['viewed_at'] = undefined;
 
 /**
- * @member {String} declined_at
+ * When they completed it.
+ * @member {Date} completed_at
  */
-SubmissionDataRequestShow.prototype['declined_at'] = undefined;
+SignatureRequest.prototype['completed_at'] = undefined;
 
 /**
- * @member {Object} data
+ * When they declined it.
+ * @member {Date} declined_at
  */
-SubmissionDataRequestShow.prototype['data'] = undefined;
+SignatureRequest.prototype['declined_at'] = undefined;
 
 /**
- * @member {module:model/SubmissionDataRequestShow.AuthTypeEnum} auth_type
+ * How your app authenticated the person before it showed them the signature request.
+ * @member {module:model/SignatureRequestAuthType} auth_type
  */
-SubmissionDataRequestShow.prototype['auth_type'] = undefined;
+SignatureRequest.prototype['auth_type'] = undefined;
 
 /**
- * @member {module:model/SubmissionDataRequestShow.AuthSecondFactorTypeEnum} auth_second_factor_type
+ * The second factor your app authenticated them with, if any.
+ * @member {module:model/SignatureRequestAuthSecondFactorType} auth_second_factor_type
  */
-SubmissionDataRequestShow.prototype['auth_second_factor_type'] = undefined;
+SignatureRequest.prototype['auth_second_factor_type'] = undefined;
 
 /**
+ * The service that authenticated them, such as `google`. Required when `auth_type` is `oauth`.
  * @member {String} auth_provider
  */
-SubmissionDataRequestShow.prototype['auth_provider'] = undefined;
+SignatureRequest.prototype['auth_provider'] = undefined;
 
 /**
- * @member {String} auth_session_started_at
+ * When your app authenticated them. Set for you with `email_link`.
+ * @member {Date} auth_session_started_at
  */
-SubmissionDataRequestShow.prototype['auth_session_started_at'] = undefined;
+SignatureRequest.prototype['auth_session_started_at'] = undefined;
 
 /**
+ * A hash of your app's session ID, for the audit trail.
  * @member {String} auth_session_id_hash
  */
-SubmissionDataRequestShow.prototype['auth_session_id_hash'] = undefined;
+SignatureRequest.prototype['auth_session_id_hash'] = undefined;
 
 /**
+ * Their user ID in your app, or a SHA-256 hash of a salt and the user ID.
  * @member {String} auth_user_id_hash
  */
-SubmissionDataRequestShow.prototype['auth_user_id_hash'] = undefined;
+SignatureRequest.prototype['auth_user_id_hash'] = undefined;
 
 /**
+ * Their username in your app, or a SHA-256 hash of a salt and the username.
  * @member {String} auth_username_hash
  */
-SubmissionDataRequestShow.prototype['auth_username_hash'] = undefined;
+SignatureRequest.prototype['auth_username_hash'] = undefined;
 
 /**
+ * The phone number they authenticated with, or a SHA-256 hash of a salt and the phone number.
  * @member {String} auth_phone_number_hash
  */
-SubmissionDataRequestShow.prototype['auth_phone_number_hash'] = undefined;
+SignatureRequest.prototype['auth_phone_number_hash'] = undefined;
 
 /**
+ * The IP address they completed the signature request from. Null in the events of a webhook that leaves out submission data.
  * @member {String} ip_address
  */
-SubmissionDataRequestShow.prototype['ip_address'] = undefined;
+SignatureRequest.prototype['ip_address'] = undefined;
 
 /**
+ * The User-Agent header of the browser they completed the signature request with. Null in the events of a webhook that leaves out submission data.
  * @member {String} user_agent
  */
-SubmissionDataRequestShow.prototype['user_agent'] = undefined;
+SignatureRequest.prototype['user_agent'] = undefined;
 
 /**
- * @member {String} submission_id
+ * When the signature request was created.
+ * @member {Date} created_at
  */
-SubmissionDataRequestShow.prototype['submission_id'] = undefined;
-
-/**
- * Allowed values for the <code>state</code> property.
- * @enum {String}
- * @readonly
- */
-SubmissionDataRequestShow['StateEnum'] = {
-  /**
-   * value: "pending"
-   * @const
-   */
-  "pending": "pending",
-  /**
-   * value: "completed"
-   * @const
-   */
-  "completed": "completed",
-  /**
-   * value: "declined"
-   * @const
-   */
-  "declined": "declined"
-};
-
-/**
- * Allowed values for the <code>auth_type</code> property.
- * @enum {String}
- * @readonly
- */
-SubmissionDataRequestShow['AuthTypeEnum'] = {
-  /**
-   * value: "none"
-   * @const
-   */
-  "none": "none",
-  /**
-   * value: "password"
-   * @const
-   */
-  "password": "password",
-  /**
-   * value: "oauth"
-   * @const
-   */
-  "oauth": "oauth",
-  /**
-   * value: "email_link"
-   * @const
-   */
-  "email_link": "email_link",
-  /**
-   * value: "phone_number"
-   * @const
-   */
-  "phone_number": "phone_number",
-  /**
-   * value: "ldap"
-   * @const
-   */
-  "ldap": "ldap",
-  /**
-   * value: "saml"
-   * @const
-   */
-  "saml": "saml"
-};
+SignatureRequest.prototype['created_at'] = undefined;
 
 /**
- * Allowed values for the <code>auth_second_factor_type</code> property.
- * @enum {String}
- * @readonly
+ * When the signature request was last updated.
+ * @member {Date} updated_at
  */
-SubmissionDataRequestShow['AuthSecondFactorTypeEnum'] = {
-  /**
-   * value: "none"
-   * @const
-   */
-  "none": "none",
-  /**
-   * value: "phone_number"
-   * @const
-   */
-  "phone_number": "phone_number",
-  /**
-   * value: "totp"
-   * @const
-   */
-  "totp": "totp",
-  /**
-   * value: "mobile_push"
-   * @const
-   */
-  "mobile_push": "mobile_push",
-  /**
-   * value: "security_key"
-   * @const
-   */
-  "security_key": "security_key",
-  /**
-   * value: "fingerprint"
-   * @const
-   */
-  "fingerprint": "fingerprint"
-};
-var _default = exports["default"] = SubmissionDataRequestShow;
+SignatureRequest.prototype['updated_at'] = undefined;
+var _default = exports["default"] = SignatureRequest;