Viewpoint API
Viewpoint (now part of Trimble) is a construction ERP platform whose Vista and Spectrum products power job-cost accounting, payroll, project management, service, and equipment for mid-to-large contractors. An unofficial API lets you programmatically pull jobs, contracts, invoices, purchase orders, payroll, and service records—and push updates like change orders, AP transactions, and work orders back into Viewpoint.
What is Viewpoint?
Viewpoint, now part of Trimble, is a construction ERP suite that connects office and field teams across financial management, payroll, project management, service, and equipment for mid-to-large contractors. Its flagship Vista ERP delivers job-cost accounting, automated invoicing, workforce and payroll management, service and equipment management, and analytics; its Spectrum ERP acts as a cloud-based central hub linking field, service, and project management teams to accounting, payroll, HR, and materials management. Both products are part of the connected Trimble Construction One suite.
Core product areas include:
- Vista ERP (job-cost accounting, financial management, invoicing, and controls)
- Spectrum ERP (cloud central hub connecting field, service, and project management to accounting and HR)
- Workforce & Payroll (union compliance, online paystubs, PTO, recruiting, HR document automation)
- Service & Equipment Management (work orders, service contracts, equipment tracking)
- Materials Management and Reporting & Analytics (inventory control, Spectrum BI, benchmarking)
Common data entities:
- Jobs, Contracts, Change Orders, Project Budgets
- Invoices, Billings, Accounts Payable, Accounts Receivable
- Purchase Orders, Subcontracts, Subcontractor records
- Employees, Payroll, Timecards, Union/Certified records
- Work Orders, Service Contracts, Equipment, Inventory/Materials
The Viewpoint Integration Challenge
Contractors run mission-critical accounting, payroll, and project workflows on Viewpoint daily, but turning those workflows into API-driven automation is non-trivial:
- Product split across Vista and Spectrum: each ERP has its own object model, IDs, and lifecycle states, so a single generic integration rarely spans both
- Eligibility and licensing gates: the Vista API is sold only to Trimble Construction One cloud-hosted Vista customers and is maintained through App Xchange, requiring purchase and provisioning before access
- On-prem and hybrid deployments: many contractors still run Vista on-prem or hybrid where no managed REST surface exists, leaving portal and database access as the only path
- Partner-marketplace routing: many capabilities flow through Trimble Marketplace and App Xchange connectors, requiring partner agreements before integration
- Authentication complexity: cloud-hosted contractor environments often add SSO and MFA that complicate headless automation
- Job-cost and payroll precision: change orders, certified payroll, and AP transactions require exact effective-date, cost-code, and reason-code handling to stay audit-clean
How Supergood Creates Viewpoint APIs
Supergood reverse-engineers authenticated browser flows and Viewpoint's available REST surfaces across Vista and Spectrum to deliver a resilient API layer for your tenant—regardless of whether you run cloud-hosted, on-prem, or hybrid.
- Handles username/password, SSO, and MFA securely in a managed session
- Maintains session continuity with automated refresh and change detection
- Normalizes responses across Vista and Spectrum so you integrate once against consistent job, accounting, and payroll objects
- Aligns with your company-specific cost codes, GL structure, and entitlements to keep writes compliant
Use Viewpoint with AI agents: Viewpoint MCP Server →
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your products (Vista, Spectrum), deployment model, and authentication setup.
- Supergood Generates and Validates Your API
We deliver a production-ready Viewpoint adapter tailored to your company configuration, cost codes, and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as Viewpoint evolves.
API Endpoints
Authentication
/authenticateAuthenticate to a Viewpoint Vista or Spectrum tenant using username/password, SSO, or MFA and obtain a session token for downstream calls.
Jobs
/jobsList jobs and contracts with filters for status, project manager, cost code, and date range across Vista and Spectrum.
Jobs
/create_change_orderSubmit a change order against an existing job with cost-code, amount, and effective-date details.
Accounting
/invoicesRetrieve AP and AR invoices, billings, and payment activity with status and vendor/customer filters.
Accounting
/create_invoicePost a new AP invoice or progress billing against a job and GL distribution.
Service
/work_ordersPull service work orders, equipment records, and service contracts with status and technician filters.
Use Cases
Sync job-cost and accounting data to your warehouse
- Pull jobs, contracts, change orders, and budgets from Vista and Spectrum into a single warehouse - Stream AP, AR, and billing transactions to downstream BI and finance tools - Reconcile cost codes and GL distributions across both ERPs for unified reporting
Automate payroll and workforce workflows
- Push timecards and labor data into Vista/Spectrum payroll without portal entry - Pull certified payroll, union, and PTO records for compliance reporting - Sync employee and recruiting records to downstream HR systems
Connect service and equipment operations
- Create and update work orders and service contracts programmatically - Pull equipment usage and maintenance records into asset-tracking tools - Surface materials and inventory levels to procurement workflows
Keep project management data in sync
- Push change orders, RFIs, and budget updates back into the ERP - Pull project budgets and job-cost insights for dashboards and forecasting - Trigger downstream alerts when cost-to-complete or margin thresholds change
Technical Specifications
Authentication
Username/password, SSO, and MFA handled in a managed session
Connectivity
Authenticated browser flows plus Viewpoint's available REST surfaces across Vista and Spectrum where exposed by your tenant
Response format
Normalized JSON across Job, Accounting, Payroll, and Service objects
Rate limits
Adaptive throttling tuned to your tenant to avoid Viewpoint-side limits
Session management
Automatic session refresh, MFA replay handling, and credential rotation
Data freshness
Near real-time pulls for jobs, invoices, and payroll with optional scheduled batch syncs
Security
Encrypted credential vault, scoped access tokens, SOC 2-aligned controls, and audit logging
Webhooks
Event-style callbacks for change orders, invoice posting, payroll runs, and work-order status changes
Latency
Sub-second reads on cached entities; multi-second writes when posting through accounting and payroll workflows
Throughput
Horizontally scaled workers sized to multi-job, multi-company contractor volume
Reliability
Retry, backoff, and idempotency keys for change orders, AP transactions, and payroll postings
Adaptation
Continuous monitoring of Vista, Spectrum, and Trimble App Xchange changes plus company-specific configuration drift
Frequently asked questions
Yes. Supergood normalizes data across both Viewpoint ERPs, so you can integrate job, accounting, payroll, and service entities once across Vista and Spectrum.
No. The official Vista API is sold only to Trimble Construction One cloud-hosted customers and maintained through App Xchange. Supergood works against your existing authenticated sessions, so you can integrate even on on-prem or hybrid deployments that have no managed REST surface.
Supergood adapts to either model. For cloud-hosted tenants we work against your Trimble Construction One instance; for on-prem or hybrid contractors we operate against the same authenticated surfaces with network configuration tuned to your environment.
Yes. Each tenant is profiled against its configured cost codes, GL distributions, and entitlements. Supergood preserves company-specific fields and lifecycle states rather than forcing a generic schema.
Yes. Beyond reads, the API supports writes such as change orders, AP/AR invoices, timecards, and work orders, with idempotency and validation against your company configuration.