calls_calls
Retrieve, filter, and sort call records by tenant, date, duration, agent, or campaign using specific search parameters for precise querying within the ServiceTitan MCP Server.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| 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"
}