Autotask icon

Autotask

Interact with Kaseya's Autotask PSA REST API to manage companies, tickets, contracts, and more.

Actions524

Contract Service Adjustment → Get Many (Advanced)

AI-generated

Overview

This node operation retrieves multiple records of Contract Service Adjustments from the Autotask PSA system using advanced filtering criteria. It is useful for scenarios where users need to query and extract detailed contract service adjustment data based on complex filters, such as specific contract IDs, adjustment types, or date ranges. For example, a user might want to get all service adjustments for a particular contract within a certain period or matching specific conditions defined in a JSON filter.

Use Case Examples

  1. Retrieve all contract service adjustments for a given contract ID using an advanced JSON filter.
  2. Fetch a limited number of contract service adjustments with specific adjustment types using the maxRecords parameter.

Properties

Name Meaning
Get All Whether to return all results or only up to a given limit (maxRecords).
Max Records Maximum number of records to return when Get All is false, with a range from 1 to 500.
Advanced Filter A JSON string containing a "filter" array with Autotask API query criteria to specify complex filtering conditions for the query.
Add Picklist Labels Whether to automatically add "_label" fields for picklist fields with human-readable values (no labels added for empty values).
Add Reference Labels Whether to automatically add "_label" fields for reference fields with human-readable values (no labels added for empty values).
Select Columns Names or IDs. Choose which fields to include in the response. If no fields are selected, all fields will be returned. The ID field is always included regardless of selection.
Flatten User-Defined Fields Whether to bring user-defined fields up to the top level of each object, making them accessible as top-level properties instead of nested in the userDefinedFields array.

Output

JSON

  • id - Unique identifier of the contract service adjustment record.
  • adjustmentAmount - The amount adjusted in the contract service.
  • adjustmentDate - The date when the adjustment was made.
  • contractId - Identifier of the contract associated with the service adjustment.
  • serviceId - Identifier of the service being adjusted.
  • adjustmentType - Type/category of the adjustment applied.
  • userDefinedFields - Array of user-defined fields related to the contract service adjustment, if not flattened.
  • picklistLabels - Optional human-readable labels for picklist fields if enabled.
  • referenceLabels - Optional human-readable labels for reference fields if enabled.

Dependencies

  • Autotask PSA REST API
  • API authentication token or API key credential

Troubleshooting

  • Ensure the advanced filter JSON is correctly formatted and valid according to Autotask API specifications to avoid query errors.
  • If no records are returned, verify the filter criteria and consider adjusting the maxRecords or enabling returnAll to fetch more data.
  • Authentication errors may occur if API credentials are missing or invalid; verify the API key or token configuration.
  • Network or API rate limit issues may cause failures; check API usage limits and retry policies.

Links

Discussion