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 |