ServicePower

Supergood | ServicePower API

Alex Klarfeld

Alex Klarfeld

— 6 min read
Supergood | ServicePower API

Programmatically access ServicePower field service data, scheduling workflows, and warranty claims with a stable REST API. Supergood builds and operates production-grade, unofficial ServicePower integrations so your team can automate dispatch, appointments, and claims processing without heavy custom engineering.

Plain English: ServicePower is field service management software used by manufacturers, retailers, insurers, and utilities to run service operations end-to-end. An unofficial API lets you pull work orders, customer and equipment details, appointment windows, technician assignments, and claim records—and push new work orders, reschedules, dispatch decisions, job outcomes, parts/labor, and claims back into ServicePower.

For a tech company integrating with ServicePower, this means you can ingest real-time job and schedule data to power dashboards, sync claims to your ERP, automate appointment booking from your customer portal, route jobs to the right contractor based on skills and capacity, or enrich your platform with photos, signatures, and completion notes. You can also push new work orders, update statuses as technicians progress, submit warranty claims with line items, and keep external systems (CRM, ERP, analytics, scheduling) aligned.

What is ServicePower?

ServicePower (https://www.servicepower.com/) is a cloud platform for field service management that connects internal technicians and third-party service providers with customers, equipment, and schedules. Teams use ServicePower to create and dispatch work orders, optimize appointments and routes, manage contractor networks and compliance, process warranty and service claims, and capture field data via mobile.

Core product areas include:

  • Work Order Management (e.g., intake, scheduling, dispatch, status tracking)
  • Smart Scheduling & Optimization (e.g., appointment windows, capacity, routing)
  • Contractor & Technician Network (e.g., skills, certifications, compliance)
  • Warranty & Claims (e.g., entitlement checks, parts/labor, approvals)
  • Field Data Capture (e.g., photos, notes, signatures, outcomes)

Common data entities:

  • Customers, Locations, and Contacts
  • Work Orders (service types, problems, SLAs, appointment windows)
  • Service Providers/Technicians (skills, regions, capacity, compliance)
  • Equipment/Assets (models, serials, entitlement/warranty status)
  • Parts and Labor line items
  • Claims (totals, approvals, artifacts)

The ServicePower Integration Challenge

Field service teams rely on ServicePower daily, but turning portal workflows and optimizer-driven decisions into API automation is non-trivial:

  • Optimizer constraints: Appointment and dispatch logic depend on skills, capacity, travel times, SLAs, and business rules that must be respected programmatically
  • Multi-entity networks: Internal technicians and third-party contractors have different entitlements, regions, and compliance requirements
  • Portal-first features: Some scheduling, claim review, and provider workflows are tuned for web UI interactions; data can be spread across screens and exports
  • Security & permissions: Role-based access, SSO/MFA, and provider scoping complicate headless data access and updates

How Supergood Creates ServicePower APIs

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

Use Cases

Work Order Data Sync

  • Mirror work orders, customers, and equipment into your internal systems
  • Keep job metadata current for operations, analytics, and CS dashboards
  • Normalize addresses, statuses, SLAs, and appointment windows across tenants

Appointment Scheduling Automation

  • Offer self-serve booking and rescheduling via your customer portal
  • Validate capacity and skills before committing appointment windows
  • Trigger optimizer-friendly updates while respecting SLAs and provider constraints

Dispatch & Capacity Management

  • Auto-assign jobs to technicians based on skills, proximity, and capacity
  • Batch-dispatch for route optimization or daily board updates
  • Track on-site ETAs, job progress, and status changes in real time

Warranty & Claims Processing

  • Submit claims with parts/labor line items and documentation
  • Sync claim statuses and totals to ERP (e.g., NetSuite, QuickBooks)
  • Automate entitlement checks and approvals workflows

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_fsm728",
    "name": "Dispatcher",
    "entitlements": ["work_orders", "scheduling", "claims"]
  }
}

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: new | scheduled | dispatched | in_progress | completed | cancelled | on_hold
  • providerId: string
  • region: string
  • scheduledFrom, scheduledTo: ISO 8601 timestamps
  • updatedFrom, updatedTo: ISO 8601 timestamps
  • page, pageSize: integers for pagination

Example response

{
  "items": [
    {
      "workOrderId": "wo_98a51c",
      "externalRef": "CRM-45672",
      "serviceType": "repair",
      "problemCode": "ICE_MAKER_NOT_WORKING",
      "status": "scheduled",
      "sla": {
        "respondBy": "2026-01-25T17:00:00Z",
        "completeBy": "2026-01-28T23:59:59Z",
        "priority": "high"
      },
      "appointmentWindow": {
        "start": "2026-01-26T13:00:00Z",
        "end": "2026-01-26T17:00:00Z"
      },
      "customer": {
        "name": "Alex Rivera",
        "phone": "+1-404-555-0199",
        "email": "[email protected]"
      },
      "location": {
        "line1": "220 Peachtree St NE",
        "city": "Atlanta",
        "region": "GA",
        "postalCode": "30303",
        "country": "US"
      },
      "equipment": {
        "model": "ACME-ICE-3000",
        "serial": "SN-883712",
        "entitlement": {
          "warranty": true,
          "expiresOn": "2026-09-30"
        }
      },
      "assignedProviderId": "sp_47bb22",
      "assignedTechId": "tech_19b7f0",
      "partsRequired": [
        {"partNumber": "ICE-VALVE-01", "quantity": 1}
      ],
      "updatedAt": "2026-01-20T14:12:00Z"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

POST /work-orders: Create a new work order with customer, equipment, and SLA details.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/work-orders \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "externalRef": "PORTAL-88932",
    "serviceType": "installation",
    "problemCode": "NEW_APPLIANCE_INSTALL",
    "customer": {
      "name": "Morgan Shaw",
      "phone": "+1-312-555-0172",
      "email": "[email protected]"
    },
    "location": {
      "line1": "1450 N State St",
      "city": "Chicago",
      "region": "IL",
      "postalCode": "60610",
      "country": "US"
    },
    "equipment": {
      "model": "ACME-DW-900",
      "serial": null,
      "entitlement": {"warranty": false}
    },
    "sla": {
      "respondBy": "2026-01-27T23:59:59Z",
      "completeBy": "2026-02-02T23:59:59Z",
      "priority": "normal"
    },
    "partsRequired": [
      {"partNumber": "DW-MOUNT-KIT", "quantity": 1}
    ],
    "notes": "Customer requests Saturday appointment if available"
  }'

Example response

{
  "workOrderId": "wo_72d3fa",
  "status": "new",
  "createdAt": "2026-01-21T09:42:18Z"
}

Dispatch

POST /work-orders/{workOrderId}/dispatch: Assign a technician/provider and set an appointment window, respecting skills and capacity.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/work-orders/wo_72d3fa/dispatch \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "assignedProviderId": "sp_47bb22",
    "assignedTechId": "tech_19b7f0",
    "appointmentWindow": {
      "start": "2026-01-29T14:00:00Z",
      "end": "2026-01-29T18:00:00Z"
    },
    "routeDate": "2026-01-29",
    "instructions": "Bring mount kit; verify water shutoff",
    "skillMatch": true,
    "requiresParts": true
  }'

Example response

{
  "dispatchId": "disp_3f9b21",
  "workOrderId": "wo_72d3fa",
  "status": "scheduled",
  "onSiteEta": "2026-01-29T15:30:00Z",
  "createdAt": "2026-01-21T10:07:03Z"
}

Claims

POST /claims: Submit a warranty/service claim with parts and labor line items, linked to a completed work order.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/claims \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "workOrderId": "wo_98a51c",
    "claimType": "warranty",
    "referenceNumber": "CLAIM-2026-00115",
    "labor": {
      "minutes": 90,
      "rate": 85.00
    },
    "parts": [
      {"partNumber": "ICE-VALVE-01", "quantity": 1, "unitCost": 42.50}
    ],
    "travel": {
      "miles": 12.3,
      "timeMinutes": 30
    },
    "taxes": 7.25,
    "attachments": [
      {"fileName": "completion_photo.jpg", "uploadToken": "upl_98dc3a"},
      {"fileName": "signed_work_order.pdf", "uploadToken": "upl_08ab73"}
    ],
    "resolution": {
      "code": "REPAIRED",
      "description": "Replaced inlet valve; unit passed test"
    }
  }'

Example response

{
  "claimId": "clm_51af80",
  "status": "submitted",
  "workOrderId": "wo_98a51c",
  "total": 178.05,
  "createdAt": "2026-01-21T11:20: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 enterprise throughput while honoring customer entitlements and optimizer usage controls
  • Session management: Automatic reauth and cookie/session rotation with health checks
  • Data freshness: Near real-time retrieval of work orders, schedules/dispatches, and claim objects
  • Security: Encrypted transport, scoped tokens, and audit logging; respects ServicePower role-based permissions and provider scoping
  • Webhooks: Optional asynchronous delivery for long-running workflows (e.g., claim approvals, job status changes, reschedules)

Performance Characteristics

  • Latency: Sub-second responses for list/detail queries under normal load
  • Throughput: Designed for high-volume work order sync and batch dispatch operations
  • 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 ServicePower adapter tailored to your workflows and entitlements.

  1. Deploy with Monitoring

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

Schedule Integration Call →

Frequently Asked Questions

Q: Which ServicePower modules can this integration cover?

Supergood supports workflows across commonly used modules such as Work Order Management, Scheduling/Dispatch, Contractor Network, and Warranty/Claims, 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 claims and financials to our ERP?

Yes. We can normalize claim records (parts, labor, taxes, totals) and deliver updates via webhooks or polling while complying with rate and permission constraints (e.g., NetSuite, QuickBooks).

Q: Are attachments and field artifacts supported for work orders?

Yes. We support downloading and uploading artifacts (photos, signatures, PDFs) via signed uploads, with checksum validation and time-limited URLs.

Ready to automate your ServicePower workflows?

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

Get Started →

Read more