simPRO API
simPRO is a cloud field service management platform that runs job management, scheduling, estimating and quoting, inventory, asset maintenance, and invoicing for trade and contracting businesses. A unified API lets you programmatically pull jobs, quotes, invoices, customers, schedules, assets, and catalog items—and push updates like new jobs, quotes, payments, and contractor records back into simPRO.
What is simPRO?
simPRO is a cloud-first field service management platform built for trade contractors and service businesses—electrical, plumbing, HVAC, security, and fire protection. Companies use simPRO Premium to manage the full job lifecycle: estimating and quoting, scheduling and dispatch, mobile field execution, stock and inventory control, asset maintenance, project tracking with progress and milestone billing, and invoicing and financial reporting.
Core product areas include:
- Job and project management (jobs, quotes, leads, cost centers, variations, progress billing)
- Estimating and quoting with catalog items, prebuilds, and takeoffs
- Scheduling and dispatch with mobile field apps for technicians
- Stock control, inventory, and vendor purchase orders
- Asset maintenance, Maintenance Planner, and recurring service jobs
- Invoicing, payments, credit notes, and financial reporting
Common data entities:
- Jobs, Quotes, Leads, Job Sections, Cost Centers, Variations
- Invoices, Credit Notes, Customer Payments, Contractor Invoices
- Customers, Contacts, Sites, Employees, Contractors, Vendors
- Activities, Activity Schedules, Assets, Asset Types, Plant & Equipment
- Catalog Items, Prebuilds, Stock, Purchase Orders, Receipts
The simPRO Integration Challenge
Trade and contracting businesses run daily operations on simPRO, but turning its field-and-office workflows into reliable API-driven automation is non-trivial:
- Per-company builds: Each simPRO Premium instance is a separate company build with its own URL, cost centers, and configuration—generic integrations break across tenants
- OAuth2 and access setup: API access requires registering an application and configuring OAuth2 credentials and scopes per company build
- Mobile-first field data: Time, photos, job notes, and payments are captured in the technician mobile app, scattering data that needs to be consolidated
- Deep entity graph: Jobs link to sections, cost centers, catalog items, prebuilds, schedules, and invoices—pulling a complete record means traversing many related endpoints
- Rate limits and pagination: High-volume reads across jobs, schedules, and catalog must respect API throttling and paginate carefully
- Module variability: Endpoint coverage shifts with the modules a company licenses—Maintenance Planner, Digital Forms, Takeoffs, and GPS each add their own objects
- Accounting sync nuances: Invoices, payments, and chart-of-accounts mappings require careful tax-code and reason handling to stay reconciled
How Supergood Creates simPRO APIs
Supergood combines simPRO's RESTful OAuth2 API with reverse-engineered authenticated browser flows to deliver a resilient, normalized API layer for your simPRO company build—covering job management, quoting, scheduling, inventory, and billing.
- Handles OAuth2 application credentials and MFA-protected logins securely in a managed session
- Maintains session continuity with automated token refresh and change detection
- Normalizes responses across Jobs, Quotes, Invoices, Schedules, Customers, and Assets so you integrate once and rely on consistent objects
- Aligns with each company build's cost centers, custom fields, and licensed modules to ensure complete, compliant access
Use simPRO with AI agents: simPRO MCP Server →
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your simPRO modules, company build, and authentication model.
- Supergood Generates and Validates Your API
We deliver a production-ready simPRO adapter tailored to your build's cost centers, modules, and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as simPRO evolves.
API Endpoints
Authentication
/authenticateAuthenticate to a simPRO company build via OAuth2 and obtain a session token for downstream calls.
Jobs
/jobsList jobs with filters for stage, status, customer, site, assigned staff, and modified-since date.
Jobs
/create_jobCreate a new job against a customer and site with cost centers, catalog items, and prebuilds.
Quotes
/quotesRetrieve quotes and leads with line items, cost centers, status, and conversion state.
Billing
/invoicesPull invoices, credit notes, and customer payments across jobs with status and date filters.
Scheduling
/schedulesList activity schedules and dispatch assignments for technicians, jobs, and recurring service work.
Use Cases
Sync jobs, quotes, and invoices into your warehouse
- Pull jobs, quotes, and cost centers from each simPRO build into a single data warehouse - Stream invoice, credit note, and payment events to downstream BI and accounting tools - Reconcile customer, site, and contact records for a unified service 360
Automate quoting and job creation workflows
- Push new quotes and jobs into simPRO from your CRM or intake forms without portal clicks - Attach catalog items, prebuilds, and takeoffs to estimates programmatically - Convert accepted quotes to jobs and route them to scheduling automatically
Keep scheduling and field data in sync
- Sync activity schedules and dispatch assignments with external calendars and routing tools - Pull technician time, job notes, and photos captured in the mobile app into reporting - Trigger recurring maintenance jobs from asset and Maintenance Planner data
Reconcile billing and inventory across systems
- Sync invoices, payments, and credit notes from simPRO into your general ledger and AR systems - Match contractor invoices and variances against purchase orders and cost centers - Surface stock levels, catalog pricing, and vendor orders to inventory and procurement tools
Technical Specifications
Authentication
OAuth2 application credentials plus MFA-protected logins handled in a managed session
Connectivity
simPRO's RESTful API (/api/v1.0/companies/{id}/...) augmented with authenticated browser flows where needed
Response format
Normalized JSON across Jobs, Quotes, Invoices, Schedules, Customers, and Asset objects
Rate limits
Adaptive throttling tuned to your company build to respect simPRO API rate limits
Session management
Automatic OAuth2 token refresh, MFA replay handling, and credential rotation
Data freshness
Near real-time pulls for jobs, schedules, and invoices with optional scheduled batch syncs
Security
Encrypted credential vault, scoped access tokens, SOC 2-aligned controls, and audit logging
Webhooks
Event-style callbacks for job, quote, and lead status changes plus invoice and payment updates
Latency
Sub-second reads on cached entities; multi-second writes when posting jobs, quotes, and invoices
Throughput
Horizontally scaled workers sized to multi-build, multi-trade job and catalog volume
Reliability
Retry, backoff, and idempotency keys for job creation, invoicing, and payment transactions
Adaptation
Continuous monitoring of simPRO releases, module changes, and per-build configuration drift
Frequently asked questions
Both. Supergood uses simPRO's RESTful OAuth2 API where it exposes the data you need, and supplements it with authenticated browser flows for workflows and fields the public API doesn't cover—presenting a single normalized surface.
Supergood works with your existing simPRO Premium company build and credentials. We handle OAuth2 application registration and token management for you, so you don't have to build and maintain the auth layer yourself.
Yes. Time entries, job notes, photos, and field-captured payments flow through the same normalized API surface, so mobile field data sits alongside office job, quote, and invoice records.
Each company build is profiled against its licensed modules. Supergood exposes the objects those modules add—maintenance schedules, digital forms, takeoffs, GPS—rather than forcing a generic schema that ignores them.
Yes. The API supports creating and updating jobs, quotes, invoices, payments, and contractor records, with idempotency and validation so writes stay consistent with your build's cost centers and tax codes.