calls_calls

Retrieve call details from ServiceTitan by filtering based on agent, campaign, duration, phone numbers, and creation/modification timestamps. Supports pagination and sorting for efficient data access.

Input Schema

Name	Required	Description
`active`	No	What kind of items should be returned (only active items will be returned by default) Values: [True, Any, False]
`agentExternalId`	No	Format - int64. Agent external ID (number)
`agentId`	No	Format - int64. Agent ID (number)
`agentIsExternal`	No	Is agent external flag (boolean)
`agentName`	No	Agent name (string)
`callerPhoneNumber`	No	The caller's phone number (string)
`campaignId`	No	Format - int64. Campaign ID
`createdAfter`	No	Format - date-time (as date-time in RFC3339). Return items created after certain date/time (in UTC)
`createdBefore`	No	Format - date-time (as date-time in RFC3339). Return items created before certain date/time (in UTC)
`createdOnOrAfter`	No	Format - date-time (as date-time in RFC3339). Return items created on or after certain date/time (in UTC)
`ids`	No	Perform lookup by multiple IDs (maximum 50)
`includeTotal`	No	Whether total count should be returned
`minDuration`	No	Format - int32. Minimum call duration (number of seconds)
`modifiedAfter`	No	Format - date-time (as date-time in RFC3339). Return items modified after certain date/time (in UTC)
`modifiedBefore`	No	Format - date-time (as date-time in RFC3339). Return items modified before certain date/time (in UTC)
`modifiedOnOrAfter`	No	Format - date-time (as date-time in RFC3339). Return items modified on or after certain date/time (in UTC)
`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)
`phoneNumberCalled`	No	The phone number that was called (string)
`sort`	No	The Sorting field, possible values: Id, CreatedOn, ModifiedOn. The Sorting is ascending by default, add the '-' character to use descending (for example -Id)
`tenant`	Yes	Format - int64. Tenant ID

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "active": {
      "description": "What kind of items should be returned (only active items will be returned by default)\nValues: [True, Any, False]",
      "type": "string"
    },
    "agentExternalId": {
      "description": "Format - int64. Agent external ID (number)",
      "type": "integer"
    },
    "agentId": {
      "description": "Format - int64. Agent ID (number)",
      "type": "integer"
    },
    "agentIsExternal": {
      "description": "Is agent external flag (boolean)",
      "type": "boolean"
    },
    "agentName": {
      "description": "Agent name (string)",
      "type": "string"
    },
    "callerPhoneNumber": {
      "description": "The caller's phone number (string)",
      "type": "string"
    },
    "campaignId": {
      "description": "Format - int64. Campaign ID",
      "type": "integer"
    },
    "createdAfter": {
      "description": "Format - date-time (as date-time in RFC3339). Return items created after certain date/time (in UTC)",
      "format": "date-time",
      "type": "string"
    },
    "createdBefore": {
      "description": "Format - date-time (as date-time in RFC3339). Return items created before certain date/time (in UTC)",
      "format": "date-time",
      "type": "string"
    },
    "createdOnOrAfter": {
      "description": "Format - date-time (as date-time in RFC3339). Return items created on or after certain date/time (in UTC)",
      "format": "date-time",
      "type": "string"
    },
    "ids": {
      "description": "Perform lookup by multiple IDs (maximum 50)",
      "type": "string"
    },
    "includeTotal": {
      "description": "Whether total count should be returned",
      "type": "boolean"
    },
    "minDuration": {
      "description": "Format - int32. Minimum call duration (number of seconds)",
      "type": "integer"
    },
    "modifiedAfter": {
      "description": "Format - date-time (as date-time in RFC3339). Return items modified after certain date/time (in UTC)",
      "format": "date-time",
      "type": "string"
    },
    "modifiedBefore": {
      "description": "Format - date-time (as date-time in RFC3339). Return items modified before certain date/time (in UTC)",
      "format": "date-time",
      "type": "string"
    },
    "modifiedOnOrAfter": {
      "description": "Format - date-time (as date-time in RFC3339). Return items modified on or after certain date/time (in UTC)",
      "format": "date-time",
      "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"
    },
    "phoneNumberCalled": {
      "description": "The phone number that was called (string)",
      "type": "string"
    },
    "sort": {
      "description": "The Sorting field, possible values: Id, CreatedOn, ModifiedOn.\nThe Sorting is ascending by default, add the '-' character to use descending (for example -Id)",
      "type": "string"
    },
    "tenant": {
      "description": "Format - int64. Tenant ID",
      "type": "integer"
    }
  },
  "required": [
    "tenant"
  ],
  "type": "object"
}

ServiceTitan MCP Server

calls_calls

Input Schema

Input Schema (JSON Schema)

Other Tools from ServiceTitan MCP Server

Related Tools