service-titan-api/src/appointments/getAppointmentAssignments.mjs

A module for authenticating and accessing the ServiceTitan API.

// src/appointmentAssignments/getAppointmentAssignments.mjs
import axios from "axios";

/**
 * Retrieves a list of appointment assignments from the ServiceTitan API.
 *
 * @param {Object} options
 * @param {ServiceTitanAuth} options.auth - An instance of ServiceTitanAuth.
 * @param {string} options.appKey - Your ServiceTitan Application Key.
 * @param {number} options.tenant - Your Tenant ID.
 * @param {Object} [options.params={}] - Optional query parameters (e.g., ids, appointmentIds, jobId, createdBefore, createdOnOrAfter, modifiedBefore, modifiedOnOrAfter, page, pageSize, includeTotal, sort, active).
 * @returns {Promise<Object>} Parsed JSON response from the API.
 */
export async function getAppointmentAssignments({
  auth,
  appKey,
  tenant,
  params = {},
}) {
  if (!auth) throw new Error("An instance of ServiceTitanAuth is required");
  if (!appKey) throw new Error("appKey is required for resource API calls");
  if (!tenant) throw new Error("tenant is required for API calls");

  const token = await auth.getAccessToken();

  // Determine the base URL based on the environment in auth.
  const baseUrl =
    auth.environment === "integration"
      ? `https://api-integration.servicetitan.io/dispatch/v2/tenant/${tenant}/appointment-assignments`
      : `https://api.servicetitan.io/dispatch/v2/tenant/${tenant}/appointment-assignments`;

  // Build query string from provided parameters.
  const queryString = new URLSearchParams(params).toString();
  const url = queryString ? `${baseUrl}?${queryString}` : baseUrl;

  try {
    const response = await axios.get(url, {
      headers: {
        Authorization: token,
        "ST-App-Key": appKey,
        "Content-Type": "application/json",
      },
    });
    return response.data;
  } catch (error) {
    const status = error.response ? error.response.status : "Unknown status";
    const statusText = error.response
      ? error.response.statusText
      : "Unknown error";
    const errorData = error.response
      ? JSON.stringify(error.response.data)
      : error.message;
    throw new Error(
      `Error fetching appointment assignments: ${status} ${statusText}: ${errorData}`
    );
  }
}