form_submission_get_form_submissions

Retrieve form submissions from ServiceTitan by filtering criteria such as tenant ID, form IDs, status, or submission date. Use this tool to manage and analyze form data efficiently.

Input Schema

Name	Required	Description
`active`	No	Values: [True, Any, False]
`createdById`	No	Format - int64. Creator user Id
`formIds`	No	Form Ids (comma separated Ids)
`includeTotal`	No	Whether total count should be returned
`ownerType`	No	Values: [Job, Call, Customer, Location, Equipment, Technician, JobAppointment, Membership, Truck]
`owners`	No	List 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
`page`	No	Format - int32. The logical number of page to return, starting from 1
`pageSize`	No	Format - int32. How many records to return (50 by default)
`sort`	No	Applies sorting by the specified field:\ "?sort=+FieldName" for ascending order,\ "?sort=-FieldName" for descending order.\ \ Available fields are: Id, SubmittedOn, CreatedBy.
`status`	No	Values: [Started, Completed, Any]
`submittedBefore`	No	Format - date-time (as date-time in RFC3339). Submission modified date before
`submittedOnOrAfter`	No	Format - date-time (as date-time in RFC3339). Submission modified date on or after
`tenant`	Yes	Format - 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"
}

This server cannot be installed

ServiceTitan MCP Server

form_submission_get_form_submissions

Input Schema

Input Schema (JSON Schema)

Other Tools from ServiceTitan MCP Server

Related Tools

MCP directory API