The ServiceCall methods allow you to access and manipulate ServiceCalls associated with your account.
The following datatype will be JSONified and returned for methods which retrieve ServiceCall values. Method requests which create new ServiceCalls or update existing ServiceCalls will be parsed for a JSON representation of this data structure.
When creating a new ServiceCall or modifying an existing ServiceCall, please set the AccountId to 0, or your AccountId as returned by the /Account method. Any other value will result in an Authentication error.
public | UInt64 | AccountId; | // The AccountId associated with this ServiceCall |
public | UInt64 | ServiceCallId; | // A unique identifier for the Service Call. Use this when making further API calls specific to this Service Call. |
public | String | WorkOrder; | // An optional parameter that can be set for your Service Calls. |
public | String | Description; | // An optional parameter that can be set for your Service Calls. |
public | DateTime? | DispatchDate; | // An optional parameter that can be set for your Service Calls. |
public | DateTime? | RequestDate; | // An optional parameter that can be set for your Service Calls. |
public | DateTime? | EstimatedStartDate; | // An optional parameter that can be set for your Service Calls. |
public | String | CustomerName; | // An optional parameter that can be set for your Service Calls. |
public | String | Caller; | // An optional parameter that can be set for your Service Calls. |
public | String | EquipmentId; | // An optional parameter that can be set for your Service Calls. |
public | String | Item; | // An optional parameter that can be set for your Service Calls. |
public | String | TerritoryDesc; | // An optional parameter that can be set for your Service Calls. |
public | String | Technician; | // An optional parameter that can be set for your Service Calls. |
public | String | BillCode; | // An optional parameter that can be set for your Service Calls. |
public | String | CallType; | // An optional parameter that can be set for your Service Calls. |
public | String | Priority; | // An optional parameter that can be set for your Service Calls. |
public | String | Status; | // An optional parameter that can be set for your Service Calls. |
public | String | Comment; | // An optional parameter that can be set for your Service Calls. |
public | String | Street; | // An optional parameter that can be set for your Service Calls. |
public | String | City; | // An optional parameter that can be set for your Service Calls. |
public | String | State; | // An optional parameter that can be set for your Service Calls. |
public | String | ZipCode; | // An optional parameter that can be set for your Service Calls. |
public | String | EquipmentRemarks; | // An optional parameter that can be set for your Service Calls. |
public | String | Contact; | // An optional parameter that can be set for your Service Calls. |
public | String | ContactPhone; | // An optional parameter that can be set for your Service Calls. |
public | Double? | Latitude; | // If Latitude and Longitude are left null, the API will attempt to retrieve their values from the Street, City, State, and ZipCoded values provided. |
public | Double? | Longitude; | // If Latitude and Longitude are left null, the API will attempt to retrieve their values from the Street, City, State, and ZipCoded values provided. |
public | String | FlagColor; | // The color of the label this service call will display in the webapp, in 6-character RGB format (eg, "FF0000" for bright red) |
public | String | TextColor; | // The color of the label text this service call will display in the webapp, in 6-character RGB format (eg, "0000FF" for bright green) |
public | String | MarkerName; | // The content of the label text this service call will display in the webapp |
The following list provides a reference for all valid /ServiceCall HTTP requests.
Summary: Removes a specific Service Call from your Account.
Returns: True if the deletion succeeded, false if the deletion failed.
Parameters:
- id: The Id of the Service Call to remove. (FromUri)
- account: (Optional) If this parameter is included, the method will be run on behalf of the specified child Account (if valid). (FromUri)
Summary: Retrieves a specific Service Call from your account.
Returns: The requested Service Call
Parameters:
- id: The Id of the Service Call to retrieve (FromUri)
- account: (Optional) If this parameter is included, the method will be run on behalf of the specified child Account (if valid). (FromUri)
Summary: Gets many or all of the Service Calls listed for your Account.
Returns: The list of Service Calls with the provided status, if specified, or all Service Calls for your Account.
Parameters:
- status: (Optional) If provided, limits the results to Service Calls with the provided status (FromUri)
- account: (Optional) If this parameter is included, the method will be run on behalf of the specified child Account (if valid). (FromUri)
Summary: Creates a new Service Call for your Account.
Returns: The newly-created Service Call as it exists in the database.
Parameters:
- ToCreate: The Service Call to create. (FromBody)
- account: (Optional) If this parameter is included, the method will be run on behalf of the specified child Account (if valid). (FromUri)
Summary: Updates an existing Service Call in your Account.
Returns: The Service Call as it exists in the database, post-update.
Parameters:
- ToUpdate: The Service Call to update, with changes applied. (FromBody)
- account: (Optional) If this parameter is included, the method will be run on behalf of the specified child Account (if valid). (FromUri)