Disclaimer Form

Owned by Joel Morgan Kearney (Unlicensed)
Last updated: Aug 07, 2023 by Joel Kearney

The Disclaimer Form API is used to access, create, and modify the different disclaimer form objects and disclaimer form data objects on your business' account. The Disclaimer Form API is connected to the Clients and Calendar APIs, in that clients receive disclaimer forms about appointments they have attended.

On this page



Disclaimer Form API Endpoints

Return to Top

These are the endpoints that are available under the /disclaimerForm path, which lists all the different disclaimer forms and disclaimer form data you have added to your business account. The disclaimerForm objects represent the templates used for your business' disclaimer forms, whereas the disclaimerFormData objects represent the individual disclaimer forms sent to clients that are based on the disclaimerForm template.

Endpoint

Description

GET /disclaimerForm

Returns all disclaimerForm objects on an account in array format.

GET /disclaimerForm/{disclaimerFormId}

Returns a JSON object form the specified disclaimer form.

POST /disclaimerForm

Creates a new disclaimerForm object or updates an existing disclaimerForm object on an account.

Request body/payload:  Must pass a disclaimerForm object in the request body/payload. If the disclaimerForm object passed doesn't have the disclaimerFormId property filled, the call will create a new disclaimer form. If the disclaimerForm object passed has the disclaimerFormId property filled, the call will update the specified disclaimer form.

For these calls, you need to pass a disclaimerForm object with all required fields and any fields you want to set filled in the body of the payload. We have an example of a resource object in the responses section below and have indicated the required fields in the object values table at the bottom of this page.

POST /disclaimerForm/{disclaimerFormId}/waive/{clientId}Marks the specified disclaimer form as waived for the specified client.
POST /disclaimerForm/{disclaimerFormUuid}/to/{clientId}

Creates a disclaimerFormObject on a client object for the client to fill out.

DELETE /disclaimerForm/{disclaimerFormId}Removes a disclaimerForm object from view by setting its active property to false.
GET /disclaimerFormData/business/{disclaimerFormId}Returns all disclaimerFormData objects sent out by the business to clients for the disclaimerFormId passed in the URL in array format.
GET /disclaimerFormData/client/{clientId}Returns all disclaimerFormData objects sent out to the specified client in array format.
GET /disclaimerFormData/client/{clientId}/form/{disclaimerFormId}Returns all disclaimerFormData objects sent out to the specified client that use the specified disclaimer form.
GET /disclaimerFormData/{disclaimerFormUUId}Returns a JSON object for disclaimerFormData that uses the specified disclaimer form.
POST /disclaimerFormData

Used by clients to submit disclaimer forms that have been sent.

Request body/payload:  Must pass a disclaimerFormData object in the request body/payload. 

For these calls, you need to pass a disclaimerFormData object with all required fields and any fields you want to set filled in the body of the payload. We have an example of a disclaimerFormData object in the responses section below and have indicated the required fields in the object values table at the bottom of this page.



Disclaimer Form API Parameters

Return to top

Data points passed on in the request URL portion of the API call that are used to filter the data being requested. 

ParameterTypeEndpoints to be used withDescription
appointmentIdintegerPOST /disclaimerForm/{disclaimerFormId}/to/{clientId}Should be set as the appointmentID of the appointment that the specified disclaimer form is being sent for.
pageNumberintegerGET /disclaimerFormData/business/{disclaimerFormId}Works with the pageSize parameter to determine how data gets returned following a GET call. The pageNumber value represents the number of pages on which the clients that get returned appear.
pageSizeintegerGET /disclaimerFormData/business/{disclaimerFormId}Works with the pageNumber parameter to determine how data gets returned following a GET call. The pageSize value represents the number of clients appearing on each page of clients that gets returned.



Disclaimer Form API Request Body/Payloads

Return to Top

The objects below represent the minimum viable objects to pass that are needed to create or update a disclaimerForm object. Check whether or not a property can be written to by looking at the Object Values table below to see if the property is writable.

POST /disclaimerForm 
{
    "active": true,
    "businessId": 43111,
    "emailAddress": "test@test.com",
    "expiresInDays": 7,
    "formName": "Waiver form",
    "formType": "HTML",
    "required": true,
    "stylesheet": null
}
POST /disclaimerFormData/{disclaimerFormUuid}/saveFieldValues 
{
    "ab7dd4f2606445caa4dc1f74835d9c48": "4"
}
POST /disclaimerFormData 
{
    "businessId": 43111,
    "calendar": {Calendar object for calendar of disclaimer form - for more info, see Calendar API page},
    "client": {Client object for client being sent disclaimer form - for more info, see Clients API page},
    "createdDate": 1658237909184,
    "createdUser": "WebClient",
    "dataJson": null,
    "dateSent": 1658238184151,
    "dateSubmitted": null,
    "disclaimerForm": {Disclaimer form object for disclaimer form of disclaimer form data},
    "disclaimerFormId": 6555,
    "disclaimerFormUuid": "1bcfb743-a23a-489c-80d4-03fbd8674a61",
    "expiresBy": 1659398400000,
    "formFields": null,
    "ipAddress": null,
    "modifiedDate": 1658238184151,
    "modifiedUser": "JoeSchmo",
    "notes": null,
    "status": "OPEN",
    "waived": null
}



Disclaimer Form API Responses

Return to Top

GET /disclaimerForm 
[{
    "active": true,
    "alreadySubmittedMsg": null,
    "businessId": 43111,
    "createdDate": 1541519350515,
    "createdUser": "JoeSchmo",
    "disclaimerFormId": 9460,
    "emailAddress": null,
    "expiresInDays": null,
    "formCreationMode": 0,
    "formFields": null,
    "formName": "Test form 1",
    "formSetupJson": null,
    "formType": "HTML",
    "hideSubmittedForms": null,
    "modifiedDate": 1541709880238,
    "modifiedUser": "JoeSchmo",
    "reasonList": [],
    "required": true,
    "stylesheet": null,
    "thankYouMsg": "<p>Thank you for submitting the form to us!</p>"
}]
GET /disclaimerForm/{disclaimerFormId} 
{
    "active": true,
    "alreadySubmittedMsg": null,
    "businessId": 43111,
    "createdDate": 1542136205563,
    "createdUser": "JoeSchmo",
    "disclaimerFormId": 6654,
    "emailAddress": null,
    "expiresInDays": 2,
    "formCreationMode": 0,
    "formFields": null,
    "formName": "Legal Disclaimer",
    "formSetupJson: null,
    "formType": "HTML",
    "hideSubmittedForms": null,
    "modifiedDate": 1542810845104,
    "modifiedUser": "JoeSchmo",
    "reasonList": null
    "required": true,
    "stylesheet": "stylesheet2.css",
    "thankYouMsg": "<p>Thank you come again</p>"
}
POST /disclaimerForm 
{
    "active": true,
    "alreadySubmittedMsg": null,
    "businessId": 43111,
    "createdDate": 1680030203978,
    "createdUser": "JoeSchmo",
    "disclaimerFormId": 49488,
    "emailAddress": "test@test.com",
    "expiresInDays": 7,
    "formCreationMode": 0,
    "formFields": null,
    "formName": "Waiver form",
    "formSetupJson": null,
    "formType": "HTML",
    "hideSubmittedForms": null,
    "modifiedDate": null,
    "modifiedUser": null,
    "reasonList": null,
    "required": true,
    "stylesheet": null,
    "thankYouMsg": null
}
POST /disclaimerForm/{disclaimerFormId}/waive/{clientId} 
{
    "businessId": 43111,
    "calendar": null,
    "client": {Client object for client being sent the specified disclaimer form - for more info, see Clients API page},
    "createdDate": 1679949080775,
    "createdUser": "JoeSchmo",
    "dataJson": null,
    "dateSent": 1679949080775,
    "dateSubmitted": 1679949080775,
    "disclaimerFormId": 11505,
    "disclaimerFormUuid": "aa2492c6-6f1a-436c-adc6-b430c44bc877",
    "expiresBy": null,
    "formFields": null,
    "formName": null,
    "ipAddress": null,
    "modifiedDate": 1679949080775,
    "modifiedUser": "JoeSchmo",
    "notes": null,
    "required": false,
    "status": "WAIVED",
    "waived": true
}
POST /disclaimerForm/{disclaimerFormUuid}/to/{clientId} 
{
    "businessId": 43111,
    "calendar": {Calendar object for calendar of disclaimer form - for more info, see Calendar API page},
    "client": {Client object for client being sent disclaimer form - for more info, see Clients API page},
    "createdDate": 1542138206956,
    "createdUser": "JoeSchmo",
    "dataJson": null,
    "dateSent": 1542138206956,
    "dateSubmitted": null,
    "disclaimerFormId": 6555,
    "disclaimerFormUuid": "14999c7a-032a-4d34-a113-a793a012186c",
    "expiresBy": 1543276800000,
    "formFields": null,
    "formName": null,
    "ipAddress": null,
    "modifiedDate": 1542138206956,
    "modifiedUser": "JoeSchmo",
    "notes": null,
    "required": false,
    "status": "OPEN",
    "waived": null
}
GET /disclaimerFormData/business/{disclaimerFormId} 
{
    "businessId": 43111,
    "calendar": {Calendar object for calendar of disclaimer form - for more info, see Calendar API page},
    "client": {Client object for client being sent disclaimer form - for more info, see Clients API page},
    "createdDate": 1677694523651,
    "createdUser": "JoeSchmo",
    "dataJson": null,
    "dateSent": 1677694523651,
    "dateSubmitted": null,
    "disclaimerFormId": 9460,
    "disclaimerFormUuid": "3fa36ce7-01d7-432c-abaf-e17ebb9f3c13",
    "expiresBy": null,
    "formFields": null,
    "formName": null,
    "ipAddress": null,
    "modifiedDate": 1677694523651,
    "modifiedUser": "JoeSchmo",
    "notes": null,
    "required": false,
    "status": "OPEN",
    "waived": null
}
GET /disclaimerFormData/client/{clientId} 
[{
    "businessId": 43111,
    "calendar": null,
    "client": {Client object for client of disclaimer form data - for more info, see Clients API page},
    "createdDate": null,
    "createdUser": null,
    "dataJson": null,
    "dateSent": null,
    "dateSubmitted": null,
    "disclaimerFormId": 6324,
    "disclaimerFormUuid": null,
    "expiresBy": null,
    "formFields": null,
    "formName": "Test form 1",
    "ipAddress": null,
    "modifiedDate": null,
    "modifiedUser": null,
    "notes": null,
    "required": true,
    "status": null,
    "waived": false
}]
GET /disclaimerFormData/client/{clientId}/form/{disclaimerFormId} (status = OPEN) 
[{
    "businessId": 43111,
    "calendar": null,
    "client": {Client object for client of disclaimer form data - for more info, see Clients API page},
    "createdDate": 1680099658123,
    "createdUser": "JoeSchmo",
    "dataJson": null,
    "dateSent": 1680099658123,
    "dateSubmitted": null,
    "disclaimerFormId": 49488,
    "disclaimerFormUuid": "7f8545d6-1777-4433-8a53-eb4f691e6223",
    "expiresBy": 1680652800000,
    "formFields": null,
    "formName": null,
    "ipAddress": null,
    "modifiedDate": 1680099658123,
    "modifiedUser": "JoeSchmo",
    "notes": null,
    "required": false,
    "status": "OPEN",
    "waived": null
}]
GET /disclaimerFormData/client/{clientId}/form/{disclaimerFormId} (status = SUBMITTED) 
[{
    "businessId": 43111,
    "calendar": {Calendar object for calendar of disclaimer form - for more info, see Calendar API page},
    "client": {Client object for client being sent disclaimer form - for more info, see Clients API page},
    "createdDate": 1662487396816,
    "createdUser": "JoeSchmo",
    "dataJson": "[{JSON of formSetupJson property from disclaimerForm object with value properties filled in}]",
    "dateSent": 1662487396816,
    "dateSubmitted": 1680102818854,
    "disclaimerFormId": 6555,
    "disclaimerFormUuid": "0d85252e-afbe-40a9-946f-e0e1268ca6f1",
    "expiresBy": 1663632000000,
    "formFields": [{
        "cssClasses": null,
        "dataType": "HTML",
        "defaultValueChoices": [{
            "label": "Manual Entry",
            "type": "manualEntry",
            "value": "",
        }],
        "displayValue": null,
        "fieldType": "variableDescription",
        "fieldValues": null,
        "hint": null,
        "htmlId": null,
        "id": "74c570e37aa44648b7b412246bcf97c9",
        "inputType": null,
        "label": "Name",
        "required": false,
        "sortOrder": 1,
        "value": "<p>Na</p>",
        "valuesArray": ["<p>Na</p>"]
    }],
    "formName": null,
    "ipAddress": null,
    "modifiedDate": 1680102818854,
    "modifiedUser": "WebClient",
    "notes": null,
    "required": false,
    "status": "SUBMITTED",
    "waived": null
}]
GET /disclaimerFormData/{disclaimerFormUuid} 
{
    "attachFileLibraryUUids": null,
    "attachmentFileLibraryList": null,
    "attachments": null,
    "bccAddress": null,
    "body": "<p>Please fill and submit this form https://www.timetap.com/form/3fa36ce7-01d7-432c-abaf-e17ebb9f3c13",
    "businessId": 43111,
    "calendarId": 20532173,
    "ccAddress": null,
    "classScheduleId": null,
    "clientAccountId": null,
    "clientId": 6110900,
    "createdDate": 1680034310353,
    "createdUser": "JoeSchmo",
    "dateProcessed": null,
    "disclaimerFormUUid": "3fa36ce7-01d7-432c-abaf-e17ebb9f3c13",
    "emailBecause": null,
    "emailCatagory": {
        "allowChange": true,
        "allowDuplicates": false,
        "allowOnline": null,
        "businessId": null,
        "code": "DISCLAIMER_FORM_CLIENT",
        "countOfTemplates": null,
        "emailCatagory": "Disclaimer Form Added",
        "emailCatagoryId": 62,
        "emailTemplateId": null,
        "enabled": null,
        "objectType": "DISCLAIMER_FORM_DATA",
        "sendICS": 0,
        "sentTo": "Client",
        "sentToClient": true,
        "sms": false,
        "sortOrder": null,
        "subject": null,
        "type": "EMAIL"
    },
    "emailFinal: null,
    "emailFooter": null,
    "emailId": null,
    "emailStatusId": 1,
    "emailTemplateId": 165138,
    "fromAddress": "noreply@timetap.com",
    "fromName": "Dog Groomers Anonymous!",
    "gateway": null,
    "icalText": null,
    "invitationUUId": null,
    "invoiceId": null,
    "jobRequisitionId": null,
    "locale": null,
    "location": null,
    "modifiedDate": null,
    "msgType": null,
    "noHeader": null,
    "packageSoldId": null,
    "postmarkAPIKey": null,
    "professionalId": 77961,
    "recurringAppointmentId": null,
    "replyToAddress": "jmorgankearney@gmail.com",
    "s3FileName: null,
    "s3FinalFileName": null,
    "s3ICSFileName": null,
    "sendError": null,
    "sendId": null,
    "sendgridAPIKey": null,
    "sentAge": null,
    "status": "QUEUED",
    "subject": "Please fill out this form",
    "templateName": null,
    "textBody": "\n\nPlease fill and submit this form https://www.timetap.com/form/3fa36ce7-01d7-432c-abaf-e17ebb9f3c13",
    "textMessage": false,
    "toAddress": "noreply@jmorgankearney.com",
    "toName": "Jay Kay",
    "twilioAuthToken": null,
    "twilioSID": null,
    "waitListId": null,
    "waitListInviteUUId": null
}
POST /disclaimerFormData 
{
    "businessId": 43111,
    "calendar": {Calendar object for calendar of disclaimer form - for more info, see Calendar API page},
    "client": {Client object for client being sent disclaimer form - for more info, see Clients API page},
    "createdDate": 1658237909184,
    "createdUser": "WebClient",
    "dataJson": "[{JSON of formSetupJson property from disclaimerForm object with value properties filled in}]",
    "dateSent": 1658238184151,
    "dateSubmitted": 168012091333,
    "disclaimerForm": {Disclaimer form object for disclaimer form of disclaimer form data},
    "disclaimerFormId": 6555,
    "disclaimerFormUuid": "1bcfb743-a23a-489c-80d4-03fbd8674a61",
    "expiresBy": 1659398400000,
    "formFields": [{
        "cssClasses": null,
        "dataType": "HTML",
        "defaultValueChoices": [{
            "label": "Manual Entry",
            "type": "manualEntry",
            "value": "",
        }],
        "displayValue": null,
        "fieldType": "variableDescription",
        "fieldValues": null,
        "hint": null,
        "htmlId": null,
        "id": "74c570e37aa44648b7b412246bcf97c9",
        "inputType": null,
        "label": "Name",
        "required": false,
        "sortOrder": 1,
        "value": "<p>Na</p>",
        "valuesArray": ["<p>Na</p>"]
    }],
    "ipAddress": null,
    "modifiedDate": 1658238184151,
    "modifiedUser": "WebClient",
    "notes": null,
    "status": "SUBMITTED",
    "waived": null
}



Disclaimer Form Object Values

Return to Top

disclaimerForm

Property nameTypeRequiredDescription
activebooleanYesIndicates whether or not the specified disclaimer form should return on GET calls.
alreadySubmittedMsgstring
Displayed as the message that gets displayed if the specified disclaimer form has already been submitted.
businessIdintegerYesProvides unique numeric ID of the business to which specified disclaimer form belongs. 
createdDateinteger
Displays as the date the specified disclaimer form was created in milliseconds elapsed since January 1, 1970 00:00:00 UTC form.
createdUserstring
Displays the username of user who created the specified disclaimer form.
disclaimerFormIdintegerYesProvides unique numeric ID for the specified disclaimer form.
emailAddressstring
Displays what is set as the Form Email Address of the specified form.
expiresInDaysinteger
Displays as the number of days left before the the specified disclaimer form expires.
formCreationModeinteger
Provides the form creation mode of the specified form.
formFieldsarray
Displays the fields objects that have been added to the specified form in array format.
formNamestringYesDisplays as what is set as the name of the specified disclaimer form.
formSetupJsonstring
Displays as JSON text describing the specified disclaimer form - for a list of properties listed in this object along with their descriptions, see table at the bottom of the page.
formTypestringYesDisplays as form type of the specified disclaimer form. Has acceptable values "HTML".

modifiedDate

integer


Displays as the date the specified disclaimer form was last modified in milliseconds elapsed since January 1, 1970 00:00:00 UTC form.

modifiedUserstring

Displays the username of the user who last modified the specified disclaimer form.

reasonListarray
Provides the reason IDs of all reasons connected to the specified disclaimer form.
requiredbooleanYesIndicates whether or not the specified disclaimer form is required.
stylesheetstring
Displays as the CSS stylesheet used to format the specified disclaimer form.
thankYouMsgstring
Displays as the thank you message that gets sent upon completion of the specified disclaimer form.

disclaimerFormData

Property nameTypeRequiredDescription
businessIdinteger
Provides unique numeric ID for the business to which the specified disclaimer form data belongs.
calendarobject
Displays the calendar object for calendar of the specified disclaimer form data - for more info, see Calendar API page.
clientobject
Displays the client object for client of the specified disclaimer form data - for more info, see Clients API page.
createdDateinteger
Displays as the date the specified disclaimer form data was created, in milliseconds elapsed since January 1, 1970 00:00:00 UTC form. 
createdUserstring
Displays the username of user who created the specified disclaimer form data.
dataJsonstring
Displays as JSON object describing any fields on specified disclaimer form data in string form.
dateSentinteger
Displays as the date the specified disclaimer form data was sent in milliseconds elapsed since January 1, 1970 00:00:00 UTC form.
dateSubmittedinteger
Displays as the date the specified disclaimer form data was submitted in milliseconds elapsed since January 1, 1970 00:00:00 UTC form.
disclaimerFormIdintegerYesProvides unique numeric ID for the specified disclaimer form data.
disclaimerFormUuidstring
Provides unique alphanumeric ID for the specified disclaimer form data.
expiresByinteger
Displays as when the specified disclaimer form data is set to expire, in milliseconds elapsed since January 1, 1970 00:00:00 UTC form.
formFieldsarray
Displays the fields objects that have been added to the specified disclaimer form data in array format.
ipAddressinteger
Displays as the IP address associated with the specified disclaimer form data.
modifiedDateinteger
Displays as the date the specified disclaimer form data was last modified, in milliseconds elapsed since January 1, 1970 00:00:00 UTC form. 
modifiedUserstring
Displays the username of the user who last modified the specified disclaimer form data.
notesstring
Displays as the text of any notes attached to the specified disclaimer form data.
requiredboolean
Indicates whether or not the specified disclaimer form data is required.
statusstring
Displays the status of specified disclaimer form. Has acceptable values "WAIVED", "SUBMITTED".
waivedboolean
Indicates whether or not the specified disclaimer form data has been waived by the business sending it.

formSetupJson

Property nameTypeDescription
fieldTypestringDisplays as the field type used for the specified disclaimer form data.
labelstringDisplays as the label appearing on the specified disclaimer form data.
valuestringDisplays as the type of value to be entered on the specified disclaimer form data.
dataTypestringDisplays as the data type used for the specified disclaimer form data.
inputTypestringDisplays as what the input is to fill out the specified disclaimer form data.
sortOrderintegerProvides a number that is used to determine the primacy of the forms.
requiredbooleanIndicates whether or not the specified disclaimer form data is required by the business.
formTypestringDisplays as the form type of the specified disclaimer form data.