ServiceTitan API - HVAC, Plumbing & Electrical Contractor Data

Access ServiceTitan data for home services businesses. Get jobs, customers, invoices, technicians, estimates, dispatch, inventory, memberships, and marketing data. The #1 platform for HVAC, plumbing, electrical, and other trade contractors.

Features

• Jobs & Dispatch: Job details, scheduling, dispatch board, technician assignments
• CRM: Customers, locations, leads, bookings, contacts
• Financials: Invoices, payments, estimates, pricebook
• Workforce: Technicians, performance metrics, payroll
• Operations: Inventory, equipment, service agreements
• Marketing: Campaigns, calls, lead tracking
• Memberships: Membership programs and service agreements
• Demo Mode: Test with realistic sample data (no credentials required)

Use Cases

HVAC Contractors

• Track job completion rates and revenue
• Monitor technician performance and efficiency
• Analyze seasonal demand patterns
• Export customer data for marketing

Plumbing Companies

• Manage service calls and dispatch
• Track inventory and parts usage
• Monitor invoice collection rates
• Analyze customer lifetime value

Electrical Contractors

• Schedule and dispatch technicians
• Track estimates vs. completed jobs
• Monitor marketing campaign ROI
• Manage membership programs

Multi-Trade Operations

• Unified reporting across business units
• Cross-sell analysis between services
• Capacity planning and forecasting
• Franchise performance comparison

Input Parameters

Task Selection

• task: Operation to perform
  • get_jobs - Get jobs list
  • get_job_details - Get specific job details
  • get_customers - Get customers
  • get_customer_details - Get customer details
  • get_locations - Get service locations
  • get_leads - Get sales leads
  • get_bookings - Get bookings
  • get_estimates - Get estimates
  • get_invoices - Get invoices
  • get_payments - Get payments
  • get_technicians - Get technicians
  • get_technician_performance - Get tech performance
  • get_dispatch_board - Get dispatch board
  • get_inventory - Get inventory items
  • get_equipment - Get equipment records
  • get_memberships - Get memberships
  • get_service_agreements - Get service agreements
  • get_marketing_campaigns - Get campaigns
  • get_calls - Get call records
  • get_payroll - Get payroll data

Authentication

• clientId: OAuth Client ID
• clientSecret: OAuth Client Secret
• appKey: Application Key
• tenantId: Tenant ID
• demoMode: Run with sample data

Filters

• jobId: Specific job lookup
• customerId: Filter by customer
• technicianId: Filter by technician
• startDate / endDate: Date range
• jobStatus: Filter by status
• businessUnitId: Filter by business unit
• campaignId: Filter by campaign

Pagination

• limit: Max records (up to 500)
• offset: Page offset

Example Output

Jobs

{
  "task": "get_jobs",
  "success": true,
  "data": {
    "jobs": [
      {
        "id": 12345678,
        "number": "JOB-2024-001234",
        "status": "Completed",
        "jobType": "Service",
        "businessUnit": "HVAC",
        "customer": {
          "id": 98765,
          "name": "John Smith"
        },
        "location": {
          "address": "123 Main St",
          "city": "Phoenix",
          "state": "AZ",
          "zip": "85001"
        },
        "technician": {
          "id": 456,
          "name": "Mike Johnson"
        },
        "scheduledDate": "2024-01-20",
        "completedDate": "2024-01-20",
        "summary": "AC not cooling - replaced capacitor",
        "invoiceTotal": 385.00,
        "duration": 90
      }
    ],
    "totalCount": 1547
  }
}

Technician Performance

{
  "task": "get_technician_performance",
  "success": true,
  "data": {
    "technician": {
      "id": 456,
      "name": "Mike Johnson",
      "department": "HVAC"
    },
    "performance": {
      "period": "2024-01",
      "jobsCompleted": 87,
      "revenue": 125650.00,
      "averageTicket": 1444.25,
      "membershipsSold": 12,
      "conversionRate": 68.5,
      "averageRating": 4.9,
      "reviewCount": 45,
      "onTimeRate": 94.2
    }
  }
}

Invoices

{
  "task": "get_invoices",
  "success": true,
  "data": {
    "invoices": [
      {
        "id": 987654,
        "number": "INV-2024-005678",
        "jobId": 12345678,
        "customerId": 98765,
        "customerName": "John Smith",
        "date": "2024-01-20",
        "dueDate": "2024-02-19",
        "status": "Paid",
        "subtotal": 350.00,
        "tax": 28.00,
        "total": 378.00,
        "balance": 0.00,
        "items": [
          {
            "description": "Capacitor Replacement",
            "quantity": 1,
            "price": 250.00
          },
          {
            "description": "Labor - 1 hour",
            "quantity": 1,
            "price": 100.00
          }
        ]
      }
    ],
    "totalCount": 3456
  }
}

ServiceTitan API Access

1. Visit ServiceTitan Developer Portal
2. Request integration environment access
3. Create an application and get credentials
4. Configure OAuth Client ID & Secret
5. Generate Application Key

Note: Production access requires ServiceTitan customer status.

Integrations

Results can be sent directly to:

• Zapier: Automate job notifications
• Make (Integromat): Build reporting workflows
• n8n: Self-hosted automation
• Custom Webhooks: Your BI tools

Pricing

Pay only for what you use:

• Jobs Query: $0.01 per query
• Customer Lookup: $0.01 per lookup
• Invoice Query: $0.01 per query
• Technician Performance: $0.02 per query
• Dispatch Board: $0.02 per query
• Marketing Data: $0.01 per query

Support

• ServiceTitan Developer Portal
• API Documentation
• API Reference

Legal

This actor integrates with the official ServiceTitan API. Users must have valid ServiceTitan credentials and appropriate permissions. Data usage is subject to ServiceTitan Terms of Service.