FieldNation

Supergood | FieldNation API

Alex Klarfeld

Alex Klarfeld

— 6 min read
Supergood | FieldNation API

Programmatically access FieldNation marketplace work orders, technician profiles, dispatch workflows, onsite deliverables, and payments with a stable REST API. Supergood builds and operates production-grade, unofficial FieldNation integrations so your team can automate field operations without heavy custom engineering.

Plain English: FieldNation is a field service marketplace that connects businesses with a nationwide network of independent technicians to complete onsite IT, retail, telecom, and maintenance work. An unofficial API lets you programmatically pull work orders, assignments, technician compliance, check-in/out events, photos and deliverables, expenses, and payment statuses—and push new work orders, dispatches, updates, and documentation back into FieldNation.

For a tech company integrating with FieldNation, this means you can ingest real-time job data to power scheduling and routing dashboards, sync expenses and payouts to accounting, automate dispatch based on skills and compliance from your product, or enrich your platform with onsite logs, photos, and customer sign-offs. You can also push new work orders, assign technicians from talent pools, capture geofenced check-ins, attach deliverables, and keep stakeholder systems (ERP, analytics, customer support, scheduling) in lockstep.

What is FieldNation?

FieldNation (https://fieldnation.com/) is a cloud platform and marketplace for field service work. Companies use FieldNation to source vetted technicians, publish and manage work orders, coordinate scheduling and dispatch, exchange messages and documents, track onsite events and deliverables, and handle expenses and payouts.

Core product areas include:

  • Marketplace & Sourcing (e.g., talent pools, skill matching, offers)
  • Work Order Management (e.g., creation, status tracking, site details, SLAs)
  • Dispatch & Scheduling (e.g., assignments, service windows, routing)
  • Technician Management & Compliance (e.g., background checks, certifications, ratings)
  • Messaging & Mobile (e.g., chat, push notifications, photo uploads)
  • Financials & Payments (e.g., expenses, approvals, payouts)
  • Quality & Deliverables (e.g., checklists, sign-offs, completion reports)
  • Documents & Attachments (e.g., photos, receipts, forms)

Common data entities:

  • Buyers/Clients, Companies, and Users
  • Technicians, Skills, Certifications, Ratings
  • Work Orders, Assignments, Statuses, SLAs
  • Schedules & Service Windows
  • Sites & Locations (addresses, access notes)
  • Events (check-in/out, arrival/departure, geolocation)
  • Deliverables (photos, notes, forms, signatures)
  • Expenses (mileage, parts, parking, receipts)
  • Approvals, Messages, Attachments
  • Invoices, Payments, Payouts

The FieldNation Integration Challenge

Field service teams rely on FieldNation daily, but turning portal-based marketplace workflows into API-driven automation is non-trivial:

  • Marketplace dynamics: Offers, acceptance, rate negotiations, and talent pool rules introduce branching logic
  • Compliance gates: Background checks, certifications, and buyer-specific requirements must be enforced programmatically
  • Geofenced events: Check-in/out validation, GPS data, and timekeeping need reliable capture and auditability
  • Document-heavy workflows: Photos, receipts, checklists, and sign-offs are optimized for mobile app flows
  • Multi-party permissions: Buyers, dispatchers, and technicians have distinct roles and entitlements that affect visibility

How Supergood Creates FieldNation APIs

Supergood reverse-engineers authenticated browser and mobile app flows to deliver a resilient API endpoint layer for your FieldNation 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 marketplace rules to ensure compliant access
  • Preserves audit trails for status changes, geolocation events, and financial actions

Use Cases

Work Order Sync & Dispatch

  • Mirror work orders, sites, and statuses into your FSM or support platform
  • Create work orders and auto-assign technicians based on skills, proximity, and compliance
  • Keep SLAs, service windows, and routing details current for scheduling and analytics

Technician Compliance & Talent Pools

  • Pull technician profiles, ratings, certifications, and background check statuses
  • Enforce buyer-specific compliance gates before assignment
  • Build and maintain talent pools with skills, regions, and availability

Onsite Events & Deliverables

  • Ingest check-in/out, GPS coordinates, time-on-site, and notes
  • Attach photos, receipts, and customer signatures to completion reports
  • Trigger follow-ups and approvals when deliverables are submitted

Financials: Expenses, Approvals, and Payouts

  • Push expense submissions (mileage, parts, parking) and track approvals
  • Pull payment statuses to reconcile with ERP (e.g., NetSuite, QuickBooks)
  • Generate alerts for exceptions (over-budget, missing receipts, delayed approvals)

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_1a29f0",
    "name": "Field Dispatcher",
    "entitlements": ["work_orders", "assignments", "technicians", "expenses", "payments"]
  }
}

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

Work Orders

GET /work-orders: List work orders with filters and summary details.

Query parameters

  • status: draft | published | assigned | in_progress | completed | approved | paid
  • clientId: string
  • technicianId: string
  • scheduledFrom, scheduledTo: ISO 8601 timestamps
  • updatedFrom, updatedTo: ISO 8601 timestamps
  • region, city: strings
  • page, pageSize: integers for pagination

Example response

{
  "items": [
    {
      "workOrderId": "wo_92f1c0",
      "externalRef": "TICKET-48321",
      "title": "Retail POS install",
      "category": "IT - POS",
      "status": "assigned",
      "clientId": "cl_55d203",
      "site": {
        "name": "Store #178",
        "address": {
          "line1": "2458 Market St",
          "city": "San Francisco",
          "region": "CA",
          "postalCode": "94114",
          "country": "US"
        }
      },
      "serviceWindow": {
        "start": "2026-02-03T09:00:00-08:00",
        "end": "2026-02-03T13:00:00-08:00"
      },
      "slaDue": "2026-02-03T18:00:00-08:00",
      "budget": 350.00,
      "currency": "USD",
      "assignedTechnician": {
        "technicianId": "tech_7b31e2",
        "name": "Jordan Lee"
      },
      "updatedAt": "2026-01-20T13:45:00Z"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

POST /work-orders: Create a new work order with site details, service window, budget, and requirements.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/work-orders \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "title": "Network switch replacement",
    "category": "IT - Networking",
    "clientId": "cl_55d203",
    "site": {
      "name": "Distribution Center",
      "address": {
        "line1": "800 Industrial Pkwy",
        "city": "Dallas",
        "region": "TX",
        "postalCode": "75201",
        "country": "US"
      },
      "accessNotes": "Dock A entry. Bring ladder."
    },
    "serviceWindow": {
      "start": "2026-02-07T08:00:00-06:00",
      "end": "2026-02-07T12:00:00-06:00"
    },
    "requirements": {
      "skills": ["networking", "switch replacement"],
      "certifications": ["CompTIA Network+"]
    },
    "budget": 425.00,
    "currency": "USD",
    "attachments": [
      {"fileName": "switch-model-spec.pdf", "uploadToken": "upl_a83c1f"}
    ],
    "notes": "Replace 48-port PoE switch. Save old unit for RMA."
  }'

Example response

{
  "workOrderId": "wo_5bd342",
  "status": "published",
  "createdAt": "2026-01-21T09:12:33Z"
}

Assignments

POST /work-orders/{workOrderId}/assignments: Assign a technician with pay details and acceptance deadline.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/work-orders/wo_5bd342/assignments \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "technicianId": "tech_7b31e2",
    "payType": "fixed",
    "payRate": 425.00,
    "currency": "USD",
    "scheduledStart": "2026-02-07T08:00:00-06:00",
    "scheduledEnd": "2026-02-07T12:00:00-06:00",
    "acceptanceDeadline": "2026-01-25T23:59:59Z",
    "message": "Please confirm availability and bring crimper and tester."
  }'

Example response

{
  "assignmentId": "asn_9c04e1",
  "status": "pending_acceptance",
  "workOrderId": "wo_5bd342",
  "createdAt": "2026-01-21T10:03:11Z"
}

Deliverables

POST /work-orders/{workOrderId}/deliverables: Submit completion report with photos, parts used, and customer sign-off.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/work-orders/wo_5bd342/deliverables \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "summary": "Replaced switch and restored connectivity to all access points.",
    "resolutionCode": "completed",
    "partsUsed": [
      {"sku": "SW-48P-POE", "description": "48-port PoE switch", "quantity": 1}
    ],
    "checklist": [
      {"item": "Cable labeling updated", "status": "done"},
      {"item": "Firmware upgraded", "status": "done"}
    ],
    "photos": [
      {"fileName": "rack-after.jpg", "uploadToken": "upl_7fa223"}
    ],
    "customerSignOff": {
      "name": "Avery Chen",
      "signatureUploadToken": "upl_sig_02bd19",
      "signedAt": "2026-02-07T11:45:00-06:00"
    },
    "notes": "Old unit boxed for RMA; MAC address recorded."
  }'

Example response

{
  "deliverableId": "del_51af80",
  "status": "submitted",
  "workOrderId": "wo_5bd342",
  "createdAt": "2026-02-07T11:50:44Z"
}

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 marketplace 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 work orders, assignments, events, deliverables, expenses, and payments
  • Security: Encrypted transport, scoped tokens, and audit logging; respects FieldNation role-based permissions and compliance gates
  • Webhooks: Optional asynchronous delivery for long-running workflows (e.g., deliverable approvals, payout processing)

Performance Characteristics

  • Latency: Sub-second responses for list/detail queries under normal load
  • Throughput: Designed for high-volume work order sync and dispatch operations
  • Reliability: Retry logic, backoff, and idempotency keys minimize duplicate actions
  • Adaptation: Continuous monitoring for UI/app changes with rapid adapter updates

Getting Started

  1. Schedule Integration Assessment

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

  1. Supergood Builds and Validates Your API

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

  1. Deploy with Monitoring

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

Schedule Integration Call →

Frequently Asked Questions

Q: Which FieldNation capabilities can this integration cover?

Supergood supports workflows across commonly used areas such as Work Orders, Assignments/Dispatch, Technician Profiles & Compliance, Messaging, Events (check-in/out), Deliverables (photos, forms, signatures), Expenses, and Payments/Payouts, 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 we auto-assign technicians from our system?

Yes. We can enforce skills, certifications, proximity, and buyer-specific compliance rules, and programmatically assign technicians or invite talent pools while respecting marketplace constraints and acceptance workflows.

Q: Are geofenced check-ins and attachments supported?

Yes. We capture check-in/out events with GPS metadata and support downloading artifacts and uploading attachments via signed uploads, with checksum validation and time-limited URLs.

Ready to automate your FieldNation workflows?

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

Get Started →

Read more