Maintenance Care

Supergood | Maintenance Care API

Alex Klarfeld

Alex Klarfeld

— 7 min read
Supergood | Maintenance Care API

Programmatically access Maintenance Care facility data—work orders, assets, preventive maintenance schedules, locations, and inventory—with a stable REST API. Supergood builds and operates production-grade, unofficial Maintenance Care integrations so your team can automate field and office processes without heavy custom engineering.

Plain English: Maintenance Care is computerized maintenance management software (CMMS) used by facility teams to manage work orders, preventive maintenance (PM), equipment/assets, parts inventory, vendor coordination, and requester portals. An unofficial API lets you programmatically pull work order queues, PM tasks, assets and locations, parts levels, labor and parts usage, and documents—and push new work requests, status updates, meter readings, PM schedules, assignments, and attachments back into Maintenance Care.

For a tech company integrating with Maintenance Care, this means you can ingest real-time maintenance and asset data to power dashboards, sync work orders to your help desk or field service tool, automate PM generation from IoT sensor events or building management systems (BMS), and keep your ERP/accounting (e.g., QuickBooks, Xero) aligned with parts usage and labor costs. You can also route requests from your tenant/resident app, trigger technician notifications, attach inspection photos, reconcile service-level agreements (SLAs), and keep stakeholder systems (ERP, analytics, CRM, scheduling) in lockstep.

What is Maintenance Care?

Maintenance Care (https://www.maintenancecare.com/) is a cloud CMMS platform for facilities management across sectors such as healthcare, education, hospitality, manufacturing, and property management. Teams use Maintenance Care to capture service requests, dispatch and track work orders, plan preventive maintenance, manage equipment/assets, control parts inventory, coordinate vendors/contractors, and log labor, parts, and documents—all through web and mobile apps with a requester portal.

Core product areas include:

  • Work Order Management (Reactive Requests, Assignments, Status/SLAs, Labor/Parts, Notes, Attachments)
  • Preventive Maintenance (PM Plans, Time-/Meter-Based Triggers, Checklists, Scheduling)
  • Asset & Equipment Management (Tags, Models/Serials, Locations, Warranty, Meter Readings)
  • Inventory/Parts Management (SKUs, Quantities, Minimums, Bin Locations, Costs)
  • Vendor & Contractor Management (Contacts, Work Assignments)
  • Locations & Spaces (Campuses, Buildings, Rooms/Zones)
  • Requester Portal & Mobile (Self-service Intake, Photos, Status Notifications)

Common data entities:

  • Organizations, Users, Roles/Permissions (Admin, Technician, Requester)
  • Work Orders (metadata, status, priority, category, SLA, labor, parts, attachments)
  • Assets/Equipment (asset tag, serial, model/manufacturer, location, status, warranty, meters)
  • Preventive Maintenance Plans/Tasks (frequency, triggers, next due, steps/checklists)
  • Locations/Buildings/Rooms (hierarchies, addresses)
  • Parts Inventory (SKU, quantity on hand, min/max, bin/stock location, unit cost)
  • Vendors/Contractors (profiles, assignments)
  • Documents/Photos & Inspection Records

The Maintenance Care Integration Challenge

Facilities teams rely on Maintenance Care daily, but turning portal-based workflows into API-driven automation is non-trivial:

  • Role-aware portals: Requesters, technicians, and admins each see different objects and fields; permissions affect data visibility and actions
  • PM intricacies: Time- and meter-based schedules, checklists, and auto-generation rules require careful handling to avoid duplicate or missed tasks
  • Attachments and photos: Files are optimized for UI workflows; programmatic upload/download often needs signed URLs and checksums
  • Authentication complexity: SSO/MFA and session lifecycles complicate headless automation across mobile and web contexts
  • Data spread: Key objects span work orders, assets, PM schedules, inventory, and locations with context in multiple views
  • Exports & API access: Many teams report limited export formats (CSV/report-based) and gated API access on higher-tier plans or add-ons—making real-time integrations costly or brittle
  • Eventing gaps: Native webhooks are limited or unavailable in many CMMS platforms, pushing teams toward polling with robust change detection

How Supergood Creates Maintenance Care APIs

Supergood reverse-engineers authenticated browser flows and network interactions to deliver a resilient API endpoint layer for your Maintenance Care 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

Work Orders & Request Intake

  • Mirror work orders into your help desk or FSM platform
  • Create new requests from apps, kiosks, or sensors
  • Automate status transitions, assignments, escalations, and notifications
  • Attach photos/documents and standardize categories, priorities, and SLAs

Preventive Maintenance & IoT Automation

  • Generate PM tasks from sensor thresholds (e.g., runtime hours, vibration, temperature)
  • Push meter readings from BMS/IoT gateways
  • Track PM completion, checklists, and next-due dates to drive SLA alerts
  • Normalize schedules across buildings and equipment classes

Asset & Location Data Sync

  • Sync assets, locations, and rooms into your CMDB/ERP
  • Keep warranty, meter readings, and decommission states current for analytics
  • Standardize tags and hierarchies for multi-site operations

Inventory & Financial Sync

  • Pull parts usage from completed work orders for job cost reporting
  • Monitor inventory levels, min/max thresholds, and trigger purchase requests
  • Reconcile labor/parts to accounting/ERP (e.g., QuickBooks, Xero) with consistent cost codes

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_mc_41c89a",
    "name": "Facilities Manager",
    "entitlements": ["work_orders", "assets", "pm", "inventory"]
  }
}

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

  • facilityId: string
  • locationId: string
  • assetId: string
  • status: open | in_progress | completed | cancelled | on_hold
  • priority: low | medium | high | urgent
  • category: reactive | preventive | inspection
  • createdFrom, createdTo: ISO 8601 timestamps
  • updatedFrom, updatedTo: ISO 8601 timestamps
  • page, pageSize: integers for pagination

Example response

{
  "items": [
    {
      "workOrderId": "wo_7e21b3",
      "number": "WO-2026-01428",
      "title": "Air handler belt replacement",
      "description": "Replace worn belt on AHU-3; check tension and alignment.",
      "status": "in_progress",
      "priority": "high",
      "category": "reactive",
      "requester": { "id": "req_1042", "name": "Front Desk" },
      "assignedTechId": "tech_88c901",
      "assignedTechName": "J. Alvarez",
      "dueDate": "2026-01-29",
      "slaHours": 24,
      "location": {
        "building": "Main Hospital",
        "room": "Mechanical Room 3",
        "locationId": "loc_5a77"
      },
      "asset": {
        "assetId": "ast_ah3",
        "tag": "AHU-3",
        "name": "Air Handling Unit"
      },
      "laborHours": 1.5,
      "partsCost": 42.50,
      "attachments": 2,
      "createdAt": "2026-01-26T10:15:00Z",
      "updatedAt": "2026-01-26T12:02:41Z"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

POST /work-orders: Create a new work order with request details and optional assignment.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/work-orders \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "title": "Replace filter on RTU-12",
    "description": "Quarterly filter change; inspect coil and drain pan.",
    "priority": "medium",
    "category": "preventive",
    "requesterId": "req_2071",
    "locationId": "loc_bldgA_roof",
    "assetId": "ast_rtu12",
    "dueDate": "2026-02-01",
    "notifyAssignee": true,
    "assignedTechId": "tech_34ab10",
    "customFields": {
      "costCenter": "HVAC",
      "permitRequired": false
    },
    "attachments": [
      { "fileName": "filter_spec.pdf", "uploadToken": "upl_9012f3" }
    ]
  }'

Example response

{
  "workOrderId": "wo_9af732",
  "number": "WO-2026-01429",
  "status": "open",
  "createdAt": "2026-01-26T13:18:09Z"
}

PATCH /work-orders/{workOrderId}: Update status, assignment, completion notes, and usage.

curl --request PATCH \
  --url https://api.supergood.ai/integrations/<integration_id>/work-orders/wo_9af732 \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "status": "completed",
    "assignedTechId": "tech_34ab10",
    "completionNotes": "Replaced filter, cleaned drain pan, verified delta P.",
    "labor": [
      { "techId": "tech_34ab10", "hours": 1.2, "costCode": "HVAC_PM" }
    ],
    "partsUsed": [
      { "sku": "FLT-20x25x2-MERV11", "quantity": 1, "unitCost": 18.75, "bin": "HVAC-Filters" }
    ],
    "attachments": [
      { "fileName": "after_photo.jpg", "uploadToken": "upl_00cd41" }
    ]
  }'

Example response

{
  "workOrderId": "wo_9af732",
  "status": "completed",
  "completedAt": "2026-01-26T14:02:33Z",
  "updatedAt": "2026-01-26T14:02:33Z"
}

Assets

GET /assets: List equipment/assets with location and warranty details.

Query parameters

  • locationId: string
  • status: active | decommissioned | retired
  • category: HVAC | Electrical | Plumbing | LifeSafety | General | Other
  • updatedFrom, updatedTo: ISO 8601 timestamps
  • page, pageSize: integers for pagination

Example response

{
  "items": [
    {
      "assetId": "ast_rtu12",
      "tag": "RTU-12",
      "name": "Rooftop Unit 12",
      "category": "HVAC",
      "manufacturer": "Trane",
      "model": "YSC120E",
      "serialNumber": "1234ABC5678",
      "status": "active",
      "location": {
        "building": "Building A",
        "room": "Roof",
        "locationId": "loc_bldgA_roof"
      },
      "warrantyExpiration": "2027-06-30",
      "meters": [
        { "type": "runtime_hours", "lastReading": 3580.5, "lastReadAt": "2026-01-20T09:12:00Z" }
      ],
      "pmSchedulesCount": 2,
      "lastServiceDate": "2025-12-01",
      "updatedAt": "2026-01-25T16:49: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 work orders, assets, PM schedules, and inventory
  • Security: Encrypted transport, scoped tokens, and audit logging; respects Maintenance Care role-based permissions
  • Webhooks: Optional asynchronous delivery for long-running workflows (e.g., PM generation, work order status changes)

Performance Characteristics

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

  1. Deploy with Monitoring

Go live with continuous monitoring and automatic adjustments as Maintenance Care evolves.

Schedule Integration Call →

Frequently Asked Questions

Q: Which Maintenance Care modules can this integration cover?

Supergood supports workflows across commonly used modules such as Work Order Management (Reactive, PM), Asset/Equipment Management, Preventive Maintenance (time-/meter-based), Inventory/Parts, and Locations, 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 labor, parts, and costs to our accounting system?

Yes. We can normalize labor entries, parts usage, and cost codes to match your ERP/accounting schema and deliver updates via webhooks or polling while complying with rate and permission constraints. We commonly integrate with QuickBooks and Xero.

Q: We’ve heard API access and exports can be limited. Can you still automate?

Many CMMS platforms gate API access or lean on CSV/report exports. Supergood’s adapter safely reverse-engineers authenticated flows to provide reliable endpoints, normalizes objects across modules, and adds change detection to avoid over-polling—even when native webhooks or APIs are limited.

Ready to automate your Maintenance Care workflows?

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

Get Started →

Read more