Disclaimer Form

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

1 Disclaimer Form API Endpoints
2 Disclaimer Form API Parameters
3 Disclaimer Form API Request Body/Payloads
4 Disclaimer Form API Responses
5 Disclaimer Form Object Values
- 5.1 disclaimerForm
- 5.2 disclaimerFormData
- 5.3 formSetupJson

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

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.

Parameter	Type	Endpoints to be used with	Description

Parameter	Type	Endpoints to be used with	Description
appointmentId	integer	POST /disclaimerForm/{disclaimerFormId}/to/{clientId}	Should be set as the appointmentID of the appointment that the specified disclaimer form is being sent for.
pageNumber	integer	GET /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.
pageSize	integer	GET /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.

{
    "active": true,
    "businessId": 43111,
    "emailAddress": "test@test.com",
    "expiresInDays": 7,
    "formName": "Waiver form",
    "formType": "HTML",
    "required": true,
    "stylesheet": null
}

{
    "ab7dd4f2606445caa4dc1f74835d9c48": "4"
}

{
    "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

[{
    "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>"
}]

{
    "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>"
}

{
    "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
}

{
    "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
}

{
    "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
}

{
    "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
}

[{
    "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
}]

[{
    "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
}]

[{
    "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
}]

{
    "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
}

{
    "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 name	Type	Required	Description

Property name	Type	Required	Description
active	boolean	Yes	Indicates whether or not the specified disclaimer form should return on GET calls.
alreadySubmittedMsg	string		Displayed as the message that gets displayed if the specified disclaimer form has already been submitted.
businessId	integer	Yes	Provides unique numeric ID of the business to which specified disclaimer form belongs.
createdDate	integer		Displays as the date the specified disclaimer form was created in milliseconds elapsed since January 1, 1970 00:00:00 UTC form.
createdUser	string		Displays the username of user who created the specified disclaimer form.
disclaimerFormId	integer	Yes	Provides unique numeric ID for the specified disclaimer form.
emailAddress	string		Displays what is set as the Form Email Address of the specified form.
expiresInDays	integer		Displays as the number of days left before the the specified disclaimer form expires.
formCreationMode	integer		Provides the form creation mode of the specified form.
formFields	array		Displays the fields objects that have been added to the specified form in array format.
formName	string	Yes	Displays as what is set as the name of the specified disclaimer form.
formSetupJson	string		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.
formType	string	Yes	Displays 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.
modifiedUser	string		Displays the username of the user who last modified the specified disclaimer form.
reasonList	array		Provides the reason IDs of all reasons connected to the specified disclaimer form.
required	boolean	Yes	Indicates whether or not the specified disclaimer form is required.
stylesheet	string		Displays as the CSS stylesheet used to format the specified disclaimer form.
thankYouMsg	string		Displays as the thank you message that gets sent upon completion of the specified disclaimer form.

disclaimerFormData

Property name	Type	Required	Description

Property name	Type	Required	Description
businessId	integer		Provides unique numeric ID for the business to which the specified disclaimer form data belongs.
calendar	object		Displays the calendar object for calendar of the specified disclaimer form data - for more info, see Calendar API page.
client	object		Displays the client object for client of the specified disclaimer form data - for more info, see C lients API page.
createdDate	integer		Displays as the date the specified disclaimer form data was created, in milliseconds elapsed since January 1, 1970 00:00:00 UTC form.
createdUser	string		Displays the username of user who created the specified disclaimer form data.
dataJson	string		Displays as JSON object describing any fields on specified disclaimer form data in string form.
dateSent	integer		Displays as the date the specified disclaimer form data was sent in milliseconds elapsed since January 1, 1970 00:00:00 UTC form.
dateSubmitted	integer		Displays as the date the specified disclaimer form data was submitted in milliseconds elapsed since January 1, 1970 00:00:00 UTC form.
disclaimerFormId	integer	Yes	Provides unique numeric ID for the specified disclaimer form data.
disclaimerFormUuid	string		Provides unique alphanumeric ID for the specified disclaimer form data.
expiresBy	integer		Displays as when the specified disclaimer form data is set to expire, in milliseconds elapsed since January 1, 1970 00:00:00 UTC form.
formFields	array		Displays the fields objects that have been added to the specified disclaimer form data in array format.
ipAddress	integer		Displays as the IP address associated with the specified disclaimer form data.
modifiedDate	integer		Displays as the date the specified disclaimer form data was last modified, in milliseconds elapsed since January 1, 1970 00:00:00 UTC form.
modifiedUser	string		Displays the username of the user who last modified the specified disclaimer form data.
notes	string		Displays as the text of any notes attached to the specified disclaimer form data.
required	boolean		Indicates whether or not the specified disclaimer form data is required.
status	string		Displays the status of specified disclaimer form. Has acceptable values "WAIVED", "SUBMITTED".
waived	boolean		Indicates whether or not the specified disclaimer form data has been waived by the business sending it.

formSetupJson

Property name	Type	Description

Property name	Type	Description
fieldType	string	Displays as the field type used for the specified disclaimer form data.
label	string	Displays as the label appearing on the specified disclaimer form data.
value	string	Displays as the type of value to be entered on the specified disclaimer form data.
dataType	string	Displays as the data type used for the specified disclaimer form data.
inputType	string	Displays as what the input is to fill out the specified disclaimer form data.
sortOrder	integer	Provides a number that is used to determine the primacy of the forms.
required	boolean	Indicates whether or not the specified disclaimer form data is required by the business.
formType	string	Displays as the form type of the specified disclaimer form data.