Fieldwire

Supergood | Fieldwire API

Alex Klarfeld

Alex Klarfeld

— 6 min read
Supergood | Fieldwire API

Programmatically access Fieldwire field operations data—projects, tasks, plans, forms, and photos—with a stable REST API. Supergood builds and operates production-grade, unofficial Fieldwire integrations so your team can automate jobsite and office workflows without heavy custom engineering.

Plain English: Fieldwire is construction field management software used by general contractors and specialty contractors to coordinate work on plans, manage tasks and punch lists, capture inspections and forms, and publish daily reports. An unofficial API lets you programmatically pull project lists, drawing sheets and versions, tasks (including checklists and comments), form templates and submissions, daily reports, and photos—and push new tasks, form entries, and attachments back into Fieldwire.

For a construction tech startup integrating with Fieldwire, this means you can ingest real-time job data to power dashboards, generate tasks from your defect detections, sync field forms and inspections into compliance workflows, align drawing versions with your BIM or estimating tools, and centralize photos and daily reports. You can also push new tasks with plan pinpoints, submit completed checklists and forms from your product, attach images and documents, and keep ERP, analytics, and scheduling systems in lockstep.

What is Fieldwire?

Fieldwire (https://www.fieldwire.com/) is a cloud platform for construction field management that connects teams on plans and coordinates the day-to-day execution of work. Crews use Fieldwire to manage tasks and punch lists, mark up drawings, complete forms and inspections, record daily reports, and share photos and files.

Core product areas include:

  • Task & Punch List Management (e.g., categories/trades, priorities, assignees, due dates, checklists)
  • Plans & As-Built Drawings (e.g., sheet versions, markups, hyperlinks, sheet numbers)
  • Forms & Inspections (e.g., custom templates, submissions, signatures, attachments)
  • Daily Reports & Scheduling (e.g., manpower, equipment, notes, weather)
  • Photos & Files (e.g., capture/upload, tagging, linking to tasks)

Common data entities:

  • Companies, Users, and Permissions
  • Projects (metadata, addresses, dates, status)
  • Plans (sheets, versions, sheet numbers, markup references)
  • Tasks & Punch List Items (titles, categories, locations, assignees, checklists, comments)
  • Forms (templates, submissions, fields, signatures)
  • Daily Reports (labor, equipment, activities, weather)
  • Photos & Attachments (files, thumbnails, links to tasks/forms)

The Fieldwire Integration Challenge

Fieldwire is used in the field every day, but turning mobile-first, plan-centric workflows into API-driven automation requires care:

  • Mobile-first behaviors: Offline capture, background sync, and session lifecycles complicate headless automation
  • Plan versioning: Sheet revisions, markups, and hyperlinks must be referenced consistently across changes
  • Entitlements & roles: Project- and company-level permissions vary by module, user, and template
  • Attachments & media: Large photo/file uploads need signed URLs, checksums, and retry logic
  • Template variability: Custom forms require flexible schemas and field types across projects

How Supergood Creates Fieldwire APIs

Supergood reverse-engineers authenticated browser flows and network interactions to deliver a resilient API endpoint layer for your Fieldwire 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 and role-based permissions to ensure compliant access

Use Cases

Project Data Sync

  • Mirror projects, companies, and users into your internal systems
  • Keep project metadata current for analytics and reporting
  • Normalize addresses, statuses, and dates for multi-project operations

Task & Punch List Automation

  • Create tasks from defect detections or QA/QC scans with plan pinpoints
  • Auto-assign categories/trades and due dates based on your rules
  • Track status, comments, and checklists to drive SLA alerts

Forms & Inspections

  • Pull form templates and publish submissions from your product
  • Capture signatures, photos, and structured fields for compliance
  • Trigger follow-ups and approvals when thresholds are met

Plans & As-Builts

  • Ingest plan sheets and versions to match your BIM or estimating workflows
  • Validate hyperlinks and references for downstream coordination
  • Detect sheet version changes and reconcile markups

Field Reporting & Photos

  • Ingest daily reports (manpower, equipment, notes, weather)
  • Centralize photos and attachments for analytics and progress tracking
  • Link artifacts to tasks and forms for full traceability

Available Endpoints

Authentication

POST /sessions: Establish 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.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/sessions \
  --header 'Authorization: Basic <Base64 encoded token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "username": "[email protected]",
    "password": "<password>",
    "mfa": { "type": "totp", "code": "123456" }
  }'

Example response

{
  "authToken": "eyJhbGciOi...",
  "expiresIn": 3600,
  "user": {
    "id": "u_b9a0c1",
    "name": "Superintendent",
    "entitlements": ["projects", "tasks", "plans", "forms"]
  }
}

POST /sessions/refresh: Refresh an existing token to keep sessions uninterrupted.

Projects

GET /projects: List projects with filters and summary details.

Query parameters

  • companyId: string
  • status: active | archived
  • updatedFrom, updatedTo: ISO 8601 timestamps
  • page, pageSize: integers for pagination

Example response

{
  "items": [
    {
      "projectId": "prj_d71f20",
      "name": "Northside Logistics Hub",
      "projectNumber": "NLH-2026-014",
      "status": "active",
      "companyId": "co_2f81ac",
      "address": {
        "line1": "1200 Industrial Pkwy",
        "city": "Dallas",
        "region": "TX",
        "postalCode": "75212",
        "country": "US"
      },
      "startDate": "2026-01-15",
      "endDate": null,
      "updatedAt": "2026-01-23T15:42:10Z"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Tasks

POST /projects/{projectId}/tasks: Create a new task or punch list item with plan location, checklist, and attachments.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/projects/prj_d71f20/tasks \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "title": "Seal penetrations at mechanical room",
    "description": "Apply firestop around conduit bundle per spec 07 84 00.",
    "category": "Firestopping",
    "priority": "high",
    "status": "open",
    "assigneeUserIds": ["u_145bb1", "u_88e4c2"],
    "dueDate": "2026-02-05",
    "planSheetId": "pln_A301",
    "pinpoint": { "x": 1342, "y": 876 },
    "location": "Level 1 - Mechanical Room 101",
    "tags": ["QA/QC", "MEP"],
    "checklistItems": [
      {"text": "Install UL-rated firestop system", "required": true},
      {"text": "Photograph completed seal", "required": true}
    ],
    "attachments": [
      {"fileName": "penetration_detail.png", "uploadToken": "upl_5c0c9f"}
    ],
    "referenceSpec": "07 84 00"
  }'

Example response

{
  "taskId": "tsk_7a3c92",
  "number": 219,
  "status": "open",
  "createdAt": "2026-01-24T09:18:02Z"
}

Forms

POST /projects/{projectId}/forms/{templateId}/submissions: Submit a form or inspection with structured fields, signatures, and attachments.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/projects/prj_d71f20/forms/tmp_safety_001/submissions \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "date": "2026-01-24",
    "submittedByUserId": "u_b9a0c1",
    "location": "Level 2 - East Stair",
    "fields": [
      {"fieldId": "fld_helmet", "type": "boolean", "value": true},
      {"fieldId": "fld_guardrails", "type": "boolean", "value": false},
      {"fieldId": "fld_notes", "type": "text", "value": "Missing mid-rail at landing."}
    ],
    "attachments": [
      {"fileName": "landing_photo.jpg", "uploadToken": "upl_92ab31"}
    ],
    "signatures": [
      {"userId": "u_b9a0c1", "role": "inspector", "signedAt": "2026-01-24T10:03:11Z"}
    ],
    "linkedTaskId": "tsk_7a3c92"
  }'

Example response

{
  "submissionId": "frm_sub_41d2e0",
  "status": "submitted",
  "createdAt": "2026-01-24T10:03:11Z"
}

Plans

GET /projects/{projectId}/plans: List plan sheets with version and status details.

Query parameters

  • versionStatus: current | superseded
  • updatedFrom, updatedTo: ISO 8601 timestamps
  • page, pageSize: integers for pagination

Example response

{
  "items": [
    {
      "planSheetId": "pln_A301",
      "sheetNumber": "A-301",
      "name": "Level 1 - Floor Plan",
      "version": 3,
      "status": "current",
      "pdfUrl": "https://signed.example.com/pln_A301_v3.pdf",
      "thumbnailUrl": "https://signed.example.com/pln_A301_v3_thumb.jpg",
      "updatedAt": "2026-01-22T08:40:00Z"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Get full API Specs →

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 projects, tasks, plans, forms, and reports
  • Security: Encrypted transport, scoped tokens, and audit logging; respects Fieldwire role-based permissions
  • Webhooks: Optional asynchronous delivery for long-running workflows (e.g., form approvals, task updates)

Performance Characteristics

  • Latency: Sub-second responses for list/detail queries under normal load
  • Throughput: Designed for high-volume project data sync, form processing, and photo ingestion
  • Reliability: Retry logic, backoff, and idempotency keys minimize duplicate actions
  • Adaptation: Continuous monitoring for UI/API changes with rapid adapter updates

Getting Started

  1. Schedule Integration Assessment

Book a 30-minute session to confirm your modules, licensing, and authentication model.

  1. Supergood Builds and Validates Your API

We deliver a hardened Fieldwire adapter tailored to your workflows and entitlements.

  1. Deploy with Monitoring

Go live with continuous monitoring and automatic adjustments as Fieldwire evolves.

Schedule Integration Call →

Frequently Asked Questions

Q: Which Fieldwire modules can this integration cover?

Supergood supports workflows across commonly used modules such as Tasks & Punch Lists, Plans & As-Builts, Forms & Inspections, Daily Reports, and Photos, subject to your licensing and entitlements. We scope coverage during integration assessment.

Q: How are MFA and SSO handled for automation?

We support username/password + MFA (SMS, email, TOTP) and can operate behind SSO/OAuth when enabled. Sessions are refreshed automatically with secure challenge handling.

Q: Can you sync forms and tasks to our ERP or analytics tools?

Yes. We can normalize tasks, forms, and daily reports to match your ERP schema (e.g., cost codes, categories) and deliver updates via webhooks or polling while complying with rate and permission constraints. Many customers reconcile costs and progress with NetSuite or QuickBooks.

Q: Are plan attachments and photos supported?

Yes. We support downloading artifacts and uploading attachments via signed uploads, with checksum validation and time-limited URLs. Photos can be linked to tasks or form submissions.

Ready to automate your Fieldwire workflows?

Supergood can have your Fieldwire integration live in days with no ongoing engineering maintenance.

Get Started →

Read more