Contractor Foreman API
Contractor Foreman is an all-in-one construction management platform for small and mid-sized residential and commercial contractors, covering project management, estimating, scheduling, time cards, financials, and documents. An unofficial API lets you programmatically pull projects, estimates, invoices, change orders, purchase orders, time cards, and daily logs—and push updates like new projects, estimates, work orders, and time entries back into Contractor Foreman.
What is Contractor Foreman?
Contractor Foreman is an all-in-one construction management platform built for small to medium-sized residential and commercial contractors. Contractors use it to run projects, build estimates and bids, manage change orders and invoices, schedule crews, capture time cards and daily logs, track costs in real time, and store project files, photos, and documents—with integrations to QuickBooks, Gusto, CompanyCam, Stripe, Zapier, and 50+ other systems.
Core product areas include:
- Project Management (projects, opportunities, daily logs, scheduling, work orders, inspections, punchlists, permits, service tickets, client portal)
- Financials (estimates, bid management, change orders, invoices, purchase orders, sub-contracts, bills and expenses, AIA/progress invoicing, online payments, cost database, takeoffs)
- People Management (directory, team chat, leads manager, time cards, crew scheduling, calendar, incidents, safety meetings)
- Documents (files and photos, reports, forms and checklists, RFIs, submittals, equipment logs, document writer, drawing/PDF markup)
Common data entities:
- Projects, Opportunities, Daily Logs, Schedules, Work Orders
- Estimates, Bids, Change Orders, Invoices, Purchase Orders, Sub-Contracts
- Clients, Contacts, Leads, Directory Records
- Time Cards, Crew Assignments, Calendar Events
- Permits, Inspections, Punchlists, Service Tickets, RFIs, Submittals
- Files, Photos, Forms, Checklists, Reports, Equipment Logs
The Contractor Foreman Integration Challenge
Contractors run daily operations on Contractor Foreman, but turning its portal- and mobile-driven workflows into reliable API-driven automation is non-trivial:
- API access is gated by plan tier: programmatic access is offered on higher subscription tiers rather than universally, so coverage varies by account
- Mobile-first field data: time cards, daily logs, photos, and punchlists are often captured in the mobile app, complicating headless extraction
- Broad object model: projects, financials, people, and documents each carry their own IDs and lifecycle states that must be reconciled
- Authentication and session handling: logged-in sessions and MFA in contractor environments complicate automated access
- Accounting sync nuances: QuickBooks, Gusto, and Stripe flows map fields differently than the native UI, so direct data needs careful normalization
- Document and photo workflows: files, markups, and PDF attachments require careful upload/download and reference handling
How Supergood Creates Contractor Foreman APIs
Supergood reverse-engineers authenticated browser and app flows to deliver a resilient, normalized API layer for your Contractor Foreman account—spanning projects, financials, people, and documents.
- Handles username/password and MFA securely in a managed session
- Maintains session continuity with automated refresh and change detection
- Normalizes responses across Projects, Estimates, Invoices, Change Orders, Time Cards, and Documents so you integrate once and rely on consistent objects
- Aligns with account-specific custom fields, cost codes, and entitlements to ensure accurate, compliant access
Use Contractor Foreman with AI agents: Contractor Foreman MCP Server →
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your modules, data entities, and authentication model.
- Supergood Generates and Validates Your API
We deliver a production-ready Contractor Foreman adapter tailored to your account configuration and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as Contractor Foreman evolves.
API Endpoints
Authentication
/authenticateAuthenticate to a Contractor Foreman account using username/password, or MFA, and obtain a session token for downstream calls.
Projects
/projectsList projects and opportunities with filters for status, client, date range, and assigned crew.
Projects
/create_projectCreate a new project or opportunity with client, schedule, budget, and cost code details.
Financials
/estimatesRetrieve estimates, bids, and change orders with line items, markups, and approval status.
Financials
/invoicesPull invoices, purchase orders, and payments including AIA/progress billing and online payment status.
Field Operations
/time_cardsRetrieve time cards, crew assignments, and daily logs across projects with date and employee filters.
Use Cases
Sync project and financial data into your warehouse
- Pull active projects, estimates, change orders, and invoices into a single warehouse - Stream cost, purchase order, and payment events to downstream BI and accounting tools - Reconcile client and project records across systems for unified reporting
Automate estimating and invoicing workflows
- Push new estimates and bids into Contractor Foreman from your CRM or takeoff tools - Pull approved estimates and convert them to invoices and change orders downstream - Route approvals, declines, and revisions without portal clicks
Centralize field time and crew data
- Sync time cards and crew assignments into payroll and Gusto workflows - Pull daily logs, punchlists, and inspections into project dashboards - Surface labor cost and crew utilization to operations reporting
Keep documents and photos in sync
- Export files, photos, and PDF markups to document management systems - Attach RFIs, submittals, and forms to downstream project records - Trigger workflows when new safety incidents or inspections are logged
Technical Specifications
Authentication
Username/password and MFA handled in a managed session
Connectivity
Authenticated browser and app flows, plus Contractor Foreman API access where exposed by the account tier
Response format
Normalized JSON across Project, Estimate, Invoice, Change Order, Time Card, and Document objects
Rate limits
Adaptive throttling tuned to your account to avoid platform-side limits
Session management
Automatic session refresh, MFA replay handling, and credential rotation
Data freshness
Near real-time pulls for projects, financials, and time cards with optional scheduled batch syncs
Security
Encrypted credential vault, scoped access tokens, SOC 2-aligned controls, and audit logging
Webhooks
Event-style callbacks for project, estimate, invoice, change order, and time card changes
Latency
Sub-second reads on cached entities; multi-second writes when posting through financial and project workflows
Throughput
Horizontally scaled workers sized to multi-project contractor volume
Reliability
Retry, backoff, and idempotency keys for estimates, invoices, and change order transactions
Adaptation
Continuous monitoring of Contractor Foreman releases and account-specific configuration drift
Frequently asked questions
Yes. Supergood works against your authenticated Contractor Foreman sessions, so you get programmatic access to projects, financials, and field data regardless of whether native API access is bundled in your subscription tier.
Yes. The normalized API supports reading projects, estimates, invoices, change orders, purchase orders, and time cards, and pushing updates like new projects, estimates, work orders, and time entries back into Contractor Foreman.
Each account is profiled against its configured custom fields, cost codes, and templates. Supergood preserves account-specific fields and lifecycle states rather than forcing a generic schema.
Yes. Time cards, daily logs, photos, and punchlists captured in the field are exposed through the same normalized API surface as data entered on the web.
Supergood complements native integrations by giving you direct, normalized access to the underlying entities, so you can build custom syncs and reporting beyond what the prebuilt connectors expose.