ServiceTitan MCP Server

form_submission_get_form_submissions

Retrieve form submissions from ServiceTitan with options to filter by form IDs, owner types, status, and submission dates, and to sort results or include total counts.

Input Schema

NameRequiredDescriptionDefault
activeNoValues: [True, Any, False]
createdByIdNoFormat - int64. Creator user Id
formIdsNoForm Ids (comma separated Ids)
includeTotalNoWhether total count should be returned
ownerTypeNoValues: [Job, Call, Customer, Location, Equipment, Technician, JobAppointment, Membership, Truck]
ownersNoList of owner object (one of Job,Customer,Location,Equipment,Call,Technician) {'type': 'xxx', 'id': 0000}\ \ Example: owners[0].type=Location&owners[0].id=2689281&\ owners[1].type=Customer&owners[1].id=2703496
pageNoFormat - int32. The logical number of page to return, starting from 1
pageSizeNoFormat - int32. How many records to return (50 by default)
sortNoApplies sorting by the specified field:\ "?sort=+FieldName" for ascending order,\ "?sort=-FieldName" for descending order.\ \ Available fields are: Id, SubmittedOn, CreatedBy.
statusNoValues: [Started, Completed, Any]
submittedBeforeNoFormat - date-time (as date-time in RFC3339). Submission modified date before
submittedOnOrAfterNoFormat - date-time (as date-time in RFC3339). Submission modified date on or after
tenantYesFormat - int64. Tenant ID

Input Schema (JSON Schema)

{ "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "active": { "description": "Values: [True, Any, False]", "type": [ "string", "null" ] }, "createdById": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Format - int64. Creator user Id" }, "formIds": { "description": "Form Ids (comma separated Ids)", "type": [ "string", "null" ] }, "includeTotal": { "description": "Whether total count should be returned", "type": [ "boolean", "null" ] }, "ownerType": { "description": "Values: [Job, Call, Customer, Location, Equipment, Technician, JobAppointment, Membership, Truck]", "type": [ "string", "null" ] }, "owners": { "description": "List of owner object (one of Job,Customer,Location,Equipment,Call,Technician) {'type': 'xxx', 'id': 0000}\\\n\\\nExample: owners[0].type=Location&owners[0].id=2689281&\\\nowners[1].type=Customer&owners[1].id=2703496", "type": [ "string", "null" ] }, "page": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Format - int32. The logical number of page to return, starting from 1" }, "pageSize": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Format - int32. How many records to return (50 by default)" }, "sort": { "description": "Applies sorting by the specified field:\\\n\"?sort=+FieldName\" for ascending order,\\\n\"?sort=-FieldName\" for descending order.\\\n\\\nAvailable fields are: Id, SubmittedOn, CreatedBy.", "type": [ "string", "null" ] }, "status": { "description": "Values: [Started, Completed, Any]", "type": [ "string", "null" ] }, "submittedBefore": { "description": "Format - date-time (as date-time in RFC3339). Submission modified date before", "type": [ "string", "null" ] }, "submittedOnOrAfter": { "description": "Format - date-time (as date-time in RFC3339). Submission modified date on or after", "type": [ "string", "null" ] }, "tenant": { "description": "Format - int64. Tenant ID", "type": "integer" } }, "required": [ "tenant" ], "type": "object" }

You must be authenticated.

Other Tools from ServiceTitan MCP Server

Related Tools

ID: mrnu4dtu2r