FieldNation API
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, chec
What is FieldNation?
FieldNation 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
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your modules, marketplace workflows, and authentication model.
- Supergood Builds and Validates Your API
We deliver a hardened FieldNation adapter tailored to your workflows and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as FieldNation evolves.
API Endpoints
Authentication
/sessionsEstablish 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.
Authentication
/sessions/refreshRefresh an existing token to keep sessions uninterrupted.
Work Orders
/work-ordersList work orders with filters and summary details.
Work Orders
/work-ordersCreate a new work order with site details, service window, budget, and requirements.
Assignments
/work-orders/{workOrderId}/assignmentsAssign a technician with pay details and acceptance deadline.
Deliverables
/work-orders/{workOrderId}/deliverablesSubmit completion report with photos, parts used, and customer sign-off.
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)
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)
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
Frequently asked questions
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.
We support username/password + MFA (SMS, email, TOTP) and can operate behind SSO/OAuth when enabled. Sessions are refreshed automatically with secure challenge handling.
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.
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.