Foundation Software API
Foundation Software develops FOUNDATION®, a construction accounting platform that unifies job costing, payroll, general ledger, and AP/AR for contractors. An unofficial API lets you programmatically pull jobs, cost codes, vendors, employees, payroll, and AP/AR records—and push updates like invoices, change orders, purchase orders, and time entries back into FOUNDATION across its connected modules.
What is Foundation Software?
Foundation Software develops FOUNDATION®, a construction accounting platform built exclusively for contractors and used to run job costing, payroll, general ledger, and accounts payable/receivable in a single integrated system. Contractors use FOUNDATION to track project costs and budget-to-actual, run multi-job and multi-trade payroll with prevailing-wage compliance, manage WIP reporting, and connect field labor data to the office. The platform extends through a family of connected modules—from mobile time tracking to project management, HR, and safety—linked through a secure API.
Core product families:
- FOUNDATION® Accounting (Job Costing, General Ledger, AP/AR, WIP reporting)
- Payroll & Payroll4Construction (multi-job, multi-trade, prevailing-wage and certified payroll)
- WorkMax (mobile time tracking with GPS and facial-recognition verification)
- ProjectHQ and CrewHQ (project management and crew scheduling)
- hrHQ, SafetyHQ, and ExecutiveHQ (HR, safety, and analytics dashboards)
- FOUNDATION Pay, Equipment & Inventory, and CPA Tools for accounting firms
Common data entities:
- Jobs, Cost Codes, Budgets, Change Orders, Purchase Orders, Subcontracts
- General Ledger Accounts, Journal Entries, WIP, Financial Statements
- Vendors, Invoices, AP Payments, Customers, AR Receipts
- Employees, Time Entries, Labor Hours, Paystubs, Tax Withholdings
- Equipment, Inventory, Certifications, Safety Incidents
The Foundation Software Integration Challenge
Contractors run mission-critical accounting and payroll on FOUNDATION daily, but turning its modules into reliable API-driven automation is non-trivial:
- Deployment variability: FOUNDATION runs in on-premise, hosted, and cloud configurations, so the available surfaces and connectivity differ by customer
- Module spread: Accounting, Payroll, WorkMax, and the HQ apps each carry their own object models, IDs, and sync semantics
- Partner-gated API access: The secure API and its documentation are provisioned per customer, requiring approval before programmatic access is granted
- Authentication complexity: Per-tenant credentials and session controls complicate headless automation
- Job-cost and prevailing-wage rules: Multi-job, multi-trade, and certified-payroll logic demands precise cost-code and wage-determination handling
- Field-to-office data flow: Time, labor, and equipment data captured in WorkMax must reconcile cleanly against jobs and cost codes in the ledger
- Document and compliance workflows: Subcontracts, lien waivers, change orders, and certified-payroll reports require careful upload/download handling
How Supergood Creates Foundation Software APIs
Supergood reverse-engineers authenticated flows and FOUNDATION's secure API surfaces to deliver a resilient, normalized API layer for your FOUNDATION deployment—across accounting, payroll, and the connected HQ modules.
- Handles username/password and MFA (SMS, email, TOTP) securely in a managed session
- Maintains session continuity with automated refresh and change detection
- Normalizes responses across Job Costing, GL, AP/AR, and Payroll so you integrate once and rely on consistent objects
- Aligns with your cost-code structure, custom fields, and module entitlements to ensure compliant access
Use Foundation Software with AI agents: Foundation Software MCP Server →
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your modules, deployment model, and authentication setup.
- Supergood Generates and Validates Your API
We deliver a production-ready FOUNDATION adapter tailored to your cost-code structure and module entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as FOUNDATION evolves.
API Endpoints
Authentication
/authenticateAuthenticate to a FOUNDATION deployment using username/password or MFA and obtain a session token for downstream calls.
Job Costing
/jobsList jobs with cost codes, budgets, and budget-to-actual status across phases and change orders.
Accounts Payable
/vendorsRetrieve vendors, subcontract details, and AP invoice and payment activity with status filters.
Accounts Payable
/create_invoiceSubmit an AP invoice against a job and cost code with distributions, retainage, and approval routing.
Payroll
/payrollPull employee records, time entries, labor hours, paystubs, and certified-payroll data across jobs and trades.
General Ledger
/general_ledgerRead general ledger accounts, journal entries, WIP, and financial statement balances by period.
Use Cases
Sync job costing and budgets into your data warehouse
- Pull jobs, cost codes, budgets, and change orders from FOUNDATION into a single warehouse - Stream budget-to-actual and committed-cost data to downstream BI and dashboards - Reconcile WIP and over/under billings across active projects
Automate accounts payable and vendor workflows
- Push AP invoices with job, cost-code, and retainage distributions into FOUNDATION - Pull vendor, subcontract, and payment status for AP automation and lien-waiver tracking - Route invoice approvals and exceptions without manual data entry
Connect field time and payroll data
- Sync time entries and labor hours from WorkMax against jobs and cost codes - Pull certified-payroll and prevailing-wage data for compliance reporting - Reconcile paystubs, tax withholdings, and labor cost back to the general ledger
Reconcile financials and reporting
- Sync general ledger accounts, journal entries, and AR receipts into accounting and FP&A systems - Surface WIP and financial statement balances for period-close and audit - Match customer billings and change orders against contract values
Technical Specifications
Authentication
Username/password and MFA (SMS, email, TOTP) handled in a managed session
Connectivity
Authenticated flows plus FOUNDATION's secure API surfaced per deployment, across on-prem, hosted, and cloud installs
Response format
Normalized JSON across Job Costing, GL, AP/AR, and Payroll objects
Rate limits
Adaptive throttling tuned to your deployment to avoid server-side limits
Session management
Automatic session refresh, MFA replay handling, and credential rotation
Data freshness
Near real-time pulls for jobs, payroll, and AP/AR with optional scheduled batch syncs
Security
Encrypted credential vault, scoped access tokens, SOC 2-aligned controls, and audit logging
Webhooks
Event-style callbacks for invoice posting, payment, change order, and payroll run changes
Latency
Sub-second reads on cached entities; multi-second writes when posting through AP and payroll workflows
Throughput
Horizontally scaled workers sized to multi-job, multi-trade payroll and AP volume
Reliability
Retry, backoff, and idempotency keys for invoices, payroll runs, and journal entries
Adaptation
Continuous monitoring of FOUNDATION releases and connected-module changes to absorb configuration drift
Frequently asked questions
Yes. Supergood adapts to your deployment model, operating against the same authenticated surfaces with network configuration tuned to your on-prem, hosted, or cloud environment.
Yes. Supergood normalizes data across FOUNDATION Accounting, Payroll, WorkMax, and the HQ modules so you integrate jobs, payroll, AP/AR, and project data through one consistent API surface.
Supergood works with your existing FOUNDATION credentials and entitlements. Where FOUNDATION's secure API is provisioned for your account we use it; otherwise we operate against the authenticated application surfaces you already have.
Your cost-code structure, job phases, and certified-payroll and prevailing-wage logic are preserved. Supergood maps to your configuration rather than forcing a generic schema, so distributions and wage determinations stay accurate.
Yes. Time entries and labor hours captured in WorkMax are reconciled against jobs and cost codes, and exposed through the same normalized API alongside payroll and general ledger entities.