ServiceTitan API
ServiceTitan is field service management software used by HVAC, plumbing, electrical, and other home and commercial service companies to run their business end-to-end. An unofficial API lets you pull customers and locations, jobs and appointments, technician statuses, pricebook items,
What is ServiceTitan?
ServiceTitan is a cloud platform for field service management that centralizes call booking, CRM, dispatching, mobile field workflows, pricebook and estimating, job costing, invoicing and payments, memberships/service agreements, and reporting. Trades contractors use ServiceTitan to schedule and dispatch technicians, manage customer communications, generate proposals, process payments, and track performance across business units.
Core product areas include:
- CRM & Call Booking (customers, locations, contacts, lead sources)
- Dispatch & Scheduling (jobs, appointments, routes, capacity, technician statuses)
- Mobile Field Operations (forms, photos, signatures, equipment, job notes)
- Pricebook, Estimates & Proposals (services, materials, equipment, options)
- Invoicing & Payments (work orders, invoices, taxes, discounts, card/ACH)
- Memberships & Recurring Services (service agreements, visits, renewals)
- Timesheets & Payroll (clock-in/out, job time, travel time)
- Inventory & Purchasing (items, warehouses, purchase orders)
Common data entities:
- Customers, Locations, Contacts, and Business Units
- Technicians/Users and Roles
- Jobs, Appointments/Visits, Dispatch Board, Statuses
- Pricebook Items (services, materials, equipment), Categories
- Estimates/Proposals, Options, Approvals
- Invoices, Line Items, Taxes, Discounts, Payments/Refunds
- Memberships/Agreements, Recurring Service Events
- Equipment/Assets at Locations, Install Dates, Serial Numbers
- Timesheets, Shifts, Payroll Codes
- Forms, Photos, Attachments, Tags
The ServiceTitan Integration Challenge
Field service teams rely on ServiceTitan daily, but turning portal-based workflows into API-driven automation is non-trivial:
- Dispatch complexity: Technician statuses (scheduled, en route, arrived, working, completed) and arrival windows must be updated carefully to avoid double-booking
- Business units and permissions: Data visibility, job types, and pricebook catalogs vary by BU and role
- Mobile-first behaviors: Many workflows (e.g., on-my-way, forms, signatures) are optimized for the tech app, not headless automation
- Financial rigor: Taxes, discounts, and payment reconciliation require accuracy and auditability
- Data sprawl: Customers, locations, jobs, estimates, invoices, memberships, and equipment are interrelated and spread across multiple screens
- Security: SSO/MFA and strong role-based access controls complicate unattended sessions
How Supergood Creates ServiceTitan APIs
Supergood reverse-engineers authenticated browser and mobile app flows to deliver a resilient API endpoint layer for your ServiceTitan tenant.
- Handles username/password, SSO/OAuth, and MFA (SMS, email, TOTP) securely
- Maintains session continuity with automated refresh and change detection
- Normalizes responses so you can integrate once and rely on consistent objects across modules
- Aligns with customer entitlements, business units, and role-based permissions to ensure compliant access
- Provides signed upload/download handling for documents, photos, and signatures
- Enforces idempotency and conflict checks to prevent double-booking or duplicate invoices
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your modules, licensing, and authentication model.
- Supergood Builds and Validates Your API
We deliver a hardened ServiceTitan adapter tailored to your workflows and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as ServiceTitan evolves.
API Endpoints
Authentication
/sessionsEstablish a session using credentials. Supergood manages MFA (SMS, email, TOTP) and SSO/OAuth when enabled. Returns a short-lived auth token maintained by the platform.
Authentication
/sessions/refreshRefresh an existing token to keep sessions uninterrupted.
Customers
/customersList customers with optional nested locations and membership summaries.
Jobs
/jobsCreate a new job for a customer/location with an initial appointment window.
Dispatch
/jobs/{jobId}/dispatchAssign or reassign technicians and set/update the scheduled window and dispatch status.
Invoices
/jobs/{jobId}/invoicesCreate an invoice for a completed job with line items, taxes, discounts, and optional payment capture.
Use Cases
Customer and Job Data Sync
- Mirror customers, locations, and installed equipment into your internal systems - Keep job metadata current for analytics and real-time dashboards - Normalize addresses, statuses, and BUs for multi-branch operations
Dispatch and Scheduling Automation
- Create jobs from your product and set arrival windows based on capacity - Assign/reassign technicians programmatically when conditions change - Trigger notifications when techs go en route, arrive, or complete
Estimate-to-Invoice Workflows
- Push approved estimates to jobs and generate invoices with tax/discount logic - Capture payments (card/ACH) and reconcile to your accounting system (e.g., QuickBooks, NetSuite) - Attach work orders, photos, and signed approvals to invoices
Memberships and Recurring Service Management
- Sync memberships and schedule recurring visits automatically - Track renewals and upsell opportunities in your CRM - Ensure contract entitlements are reflected in jobs and invoices
Technical Specifications
Authentication
Username/password with MFA (SMS, email, TOTP) and SSO/OAuth where enabled; supports service accounts or customer-managed credentials
Response format
JSON with consistent resource schemas and pagination across modules
Rate limits
Tuned for enterprise throughput while honoring customer entitlements and usage controls
Session management
Automatic reauth and cookie/session rotation with health checks
Data freshness
Near real-time retrieval of customers, jobs, dispatch updates, and financial objects
Security
Encrypted transport, scoped tokens, and audit logging; respects ServiceTitan role-based permissions and business units
Webhooks
Optional asynchronous delivery for long-running workflows (e.g., job status changes, invoice payments)
Latency
Sub-second responses for list/detail queries under normal load
Throughput
Designed for high-volume customer/job sync and invoice processing
Reliability
Retry logic, backoff, and idempotency keys minimize duplicate actions
Adaptation
Continuous monitoring for UI/API changes with rapid adapter updates
Frequently asked questions
Supergood supports workflows across commonly used modules such as CRM (customers, locations), Dispatch & Scheduling (jobs, appointments, technician statuses), Pricebook & Estimates, and Invoicing & Payments, plus Memberships/Recurring Services—subject to your licensing and entitlements. We scope coverage during integration assessment.
We support username/password + MFA (SMS, email, TOTP) and can operate behind SSO/OAuth when enabled. Sessions are refreshed automatically with secure challenge handling.
Yes. We can normalize invoices and payments to match your ERP schema (e.g., tax, discounts, line items) and deliver updates via webhooks or polling while complying with rate and permission constraints. We commonly integrate with QuickBooks and NetSuite.
Yes. We can create jobs, set arrival windows, assign/reassign technicians, and track en route/arrived/completed statuses while preventing scheduling conflicts and respecting capacity constraints.
Yes. We support downloading artifacts (photos, PDFs, signed approvals) and uploading attachments via signed uploads, with checksum validation and time-limited URLs.