tasks_get_tasks

Retrieve task data from ServiceTitan based on filters like status, dates, priorities, and assigned users to manage and track task-related workflows efficiently.

Input Schema

Name	Required	Description
`active`	No	Values: [True, Any, False]
`assignedToId`	No	Format - int64. Assigned to Id
`businessUnitIds`	No	Business Unit Ids (comma separated Ids)
`completeBefore`	No	Format - date-time (as date-time in RFC3339). Completed Before
`completeOnOrAfter`	No	Format - date-time (as date-time in RFC3339). Completed On or After
`createdBefore`	No	Format - date-time (as date-time in RFC3339). Created date before
`createdOnOrAfter`	No	Format - date-time (as date-time in RFC3339). Created date on or after
`customerId`	No	Format - int64. Customer Id
`employeeTaskResolutionIds`	No	EmployeeTaskResolution Ids (comma separated Ids)
`employeeTaskSourceIds`	No	EmployeeTaskSource Ids (comma separated Ids)
`employeeTaskTypeIds`	No	EmployeeTaskType Ids (comma separated Ids)
`ids`	No	Task Ids (comma separated Ids)
`includeSubtasks`	No	Include Subtasks
`includeTotal`	No	Whether total count should be returned
`involvedEmployeeIdList`	No	Involved Employee Ids (comma separated Ids)
`isClosed`	No	Is Closed This property is deprecated. Use Statuses instead.
`jobId`	No	Format - int64. Job Id
`jobNumber`	No	Job Number
`modifiedBefore`	No	Format - date-time (as date-time in RFC3339). Modified date before
`modifiedOnOrAfter`	No	Format - date-time (as date-time in RFC3339). Modified date on or after
`name`	No	Name
`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)
`priorities`	No	Priorities (comma separated values)
`projectId`	No	Format - int64. Project Id
`reportedBefore`	No	Format - date-time (as date-time in RFC3339). Reported date before
`reportedById`	No	Format - int64. Reported By Id
`reportedOnOrAfter`	No	Format - date-time (as date-time in RFC3339). Reported On or After
`sort`	No	Applies sorting by the specified field: "?sort=+FieldName" for ascending order, "?sort=-FieldName" for descending order. Available fields are: Id, CreatedOn, DescriptionModifiedOn, CompletedBy, Priority
`statuses`	No	Task Status
`taskNumber`	No	Format - int64. Task Number
`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"
    },
    "assignedToId": {
      "description": "Format - int64. Assigned to Id",
      "type": "integer"
    },
    "businessUnitIds": {
      "description": "Business Unit Ids (comma separated Ids)",
      "type": "string"
    },
    "completeBefore": {
      "description": "Format - date-time (as date-time in RFC3339). Completed Before",
      "format": "date-time",
      "type": "string"
    },
    "completeOnOrAfter": {
      "description": "Format - date-time (as date-time in RFC3339). Completed On or After",
      "format": "date-time",
      "type": "string"
    },
    "createdBefore": {
      "description": "Format - date-time (as date-time in RFC3339). Created date before",
      "format": "date-time",
      "type": "string"
    },
    "createdOnOrAfter": {
      "description": "Format - date-time (as date-time in RFC3339). Created date on or after",
      "format": "date-time",
      "type": "string"
    },
    "customerId": {
      "description": "Format - int64. Customer Id",
      "type": "integer"
    },
    "employeeTaskResolutionIds": {
      "description": "EmployeeTaskResolution Ids (comma separated Ids)",
      "type": "string"
    },
    "employeeTaskSourceIds": {
      "description": "EmployeeTaskSource Ids (comma separated Ids)",
      "type": "string"
    },
    "employeeTaskTypeIds": {
      "description": "EmployeeTaskType Ids (comma separated Ids)",
      "type": "string"
    },
    "ids": {
      "description": "Task Ids (comma separated Ids)",
      "type": "string"
    },
    "includeSubtasks": {
      "description": "Include Subtasks",
      "type": "boolean"
    },
    "includeTotal": {
      "description": "Whether total count should be returned",
      "type": "boolean"
    },
    "involvedEmployeeIdList": {
      "description": "Involved Employee Ids (comma separated Ids)",
      "type": "string"
    },
    "isClosed": {
      "description": "Is Closed\nThis property is deprecated. Use Statuses instead.",
      "type": "boolean"
    },
    "jobId": {
      "description": "Format - int64. Job Id",
      "type": "integer"
    },
    "jobNumber": {
      "description": "Job Number",
      "type": "string"
    },
    "modifiedBefore": {
      "description": "Format - date-time (as date-time in RFC3339). Modified date before",
      "format": "date-time",
      "type": "string"
    },
    "modifiedOnOrAfter": {
      "description": "Format - date-time (as date-time in RFC3339). Modified date on or after",
      "format": "date-time",
      "type": "string"
    },
    "name": {
      "description": "Name",
      "type": "string"
    },
    "page": {
      "description": "Format - int32. The logical number of page to return, starting from 1",
      "type": "integer"
    },
    "pageSize": {
      "description": "Format - int32. How many records to return (50 by default)",
      "type": "integer"
    },
    "priorities": {
      "description": "Priorities (comma separated values)",
      "type": "string"
    },
    "projectId": {
      "description": "Format - int64. Project Id",
      "type": "integer"
    },
    "reportedBefore": {
      "description": "Format - date-time (as date-time in RFC3339). Reported date before",
      "format": "date-time",
      "type": "string"
    },
    "reportedById": {
      "description": "Format - int64. Reported By Id",
      "type": "integer"
    },
    "reportedOnOrAfter": {
      "description": "Format - date-time (as date-time in RFC3339). Reported On or After",
      "format": "date-time",
      "type": "string"
    },
    "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, CreatedOn, DescriptionModifiedOn, CompletedBy, Priority",
      "type": "string"
    },
    "statuses": {
      "description": "Task Status",
      "type": "string"
    },
    "taskNumber": {
      "description": "Format - int64. Task Number",
      "type": "integer"
    },
    "tenant": {
      "description": "Format - int64. Tenant ID",
      "type": "integer"
    }
  },
  "required": [
    "tenant"
  ],
  "type": "object"
}

ServiceTitan MCP Server

tasks_get_tasks

Input Schema

Input Schema (JSON Schema)

Other Tools from ServiceTitan MCP Server

Related Tools