Supergood | Limble CMMS API

Supergood | Limble CMMS API

Programmatically access Limble CMMS assets, work orders, preventive maintenance plans, inventory, and request/approval workflows with a stable REST API. Supergood builds and operates production-grade, unofficial Limble CMMS integrations so your team can automate maintenance processes without heavy custom engineering.

Plain English: Limble CMMS is maintenance management software for facilities and operations teams to track assets, create and complete work orders, schedule preventive maintenance (PMs), manage parts inventory, and report on uptime and costs. An unofficial API lets you pull asset hierarchies, open/closed work orders, PM schedules, parts levels and transactions, checklists, meter readings, and attachments—and push new work orders, status updates, time/parts consumed, and inventory adjustments back into Limble.

For a tech company integrating with Limble, this means you can ingest real-time equipment and WO data to power analytics, sync purchase/issue transactions to accounting/ERP (e.g., QuickBooks, Xero), drive automations from your sensors/IoT (e.g., create a WO when a meter threshold is exceeded), feed BI tools (e.g., Power BI) with downtime and labor data, or embed a request-to-resolution experience in your product. You can also update technician assignments, attach photos and documents, maintain parts replenishment signals, and keep downstream systems (ERP, EAM, analytics, field service) in lockstep.

What is Limble CMMS?

Limble CMMS (https://limblecmms.com/) is a cloud-based computerized maintenance management system used across facilities, manufacturing, utilities, hospitality, and other asset-intensive operations. Teams use Limble to structure their asset registry, run preventive and reactive maintenance, track parts and suppliers, enable request portals, and analyze performance and costs. A mobile-first interface, QR codes, and checklists streamline technician workflows.

Core product areas include:

  • Asset & Location Management (Equipment, Child Assets/Components, Locations, QR/Barcodes, Meters)
  • Work Management (Work Requests, Work Orders, Assignments, Priorities, Checklists, Time & Costs, Attachments)
  • Preventive Maintenance (Calendar- and Meter-based Schedules, Templates, Auto-Generated WOs)
  • Inventory & Purchasing (Parts/Bins/Stock Levels, Issue/Receive/Transfer, Vendors, Reorder Points)
  • Reporting & Insights (Downtime, MTTR/MTBF, Compliance, Cost Tracking)
  • Collaboration (Requester Portal, Notifications, Technician Mobile App)

Common data entities:

  • Users/Technicians, Roles/Permissions
  • Assets & Components (hierarchies), Locations, Meters
  • Work Requests and Work Orders (tasks, checklists, labor, parts, costs, attachments)
  • Preventive Maintenance Schedules and Templates (frequency, triggers)
  • Parts/Inventory (bins, stock levels, transactions), Vendors
  • Documents/Photos, Comments/Activity, Status/Approval Flows

The Limble CMMS Integration Challenge

Maintenance teams rely on Limble daily, but turning portal-first workflows into API-driven automation is non-trivial:

  • Asset hierarchy and context: Parent/child assets, locations, and meters require careful joins for analytics and automations
  • WO lifecycle complexity: Statuses (requested → approved → in_progress → completed) and checklists/time/parts must be atomically handled
  • PM generation: Templates and schedules spawn WOs with floating/fixed due dates and meter triggers that are easy to misinterpret
  • Attachments and scans: Photos, documents, and QR flows are optimized for the app UI, not headless ingestion
  • Data export/API access: Teams report limited self-serve exports, paid/enterprise API access, and a lack of webhooks—forcing polling or manual CSVs
  • Authentication & roles: SSO/MFA and role-based visibility complicate background jobs and service accounts

How Supergood Creates Limble CMMS APIs

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

Asset & Work Order Data Sync

  • Mirror assets, locations, meters, and WOs into your data warehouse or EAM
  • Keep equipment metadata and status current for analytics and CMMS-to-ERP alignment
  • Normalize hierarchies, criticality, and custom fields across sites

Preventive Maintenance & IoT Automation

  • Read PM schedules and next due dates to drive staffing and parts staging
  • Create WOs automatically from sensor alerts or meter thresholds
  • Feed back time/parts usage and closure notes for compliance and reporting

Inventory & Procurement

  • Post issue/receive transactions from storeroom or ERP to maintain true-on-hand
  • Trigger purchase requests or reorder tasks when stock dips below thresholds
  • Reconcile costs by WO, asset, and GL/Cost Center

Request Portals & Field Reporting

  • Embed request intake in your product and push approved requests into Limble as WOs
  • Attach photos, documents, and QA checklists from mobile or third-party apps
  • Stream technician updates, comments, and completion artifacts to stakeholders

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_lmble_42a9d1",
    "name": "Maintenance Manager",
    "entitlements": ["assets", "work_orders", "pm_schedules", "inventory"]
  }
}

Assets

GET /assets: List assets with hierarchy, meters, and key attributes.

Query parameters

  • locationId: string
  • status: active | inactive | decommissioned
  • updatedFrom, updatedTo: ISO 8601 timestamps
  • include: comma-separated includes (meters, parents, children)
  • page, pageSize: integers for pagination

Example response

{
  "items": [
    {
      "assetId": "ast_9f2c11",
      "name": "Air Handler AHU-03",
      "code": "AHU-03",
      "status": "active",
      "locationId": "loc_northwing",
      "parentAssetId": "ast_plantroom",
      "criticality": "high",
      "manufacturer": "Trane",
      "model": "X4500",
      "serialNumber": "TRN-4500-99381",
      "meters": [
        {"meterId": "mtr_hrs", "type": "runtime_hours", "unit": "hours", "reading": 12438, "updatedAt": "2026-01-18T07:20:00Z"}
      ],
      "customFields": {"area": "HVAC", "installDate": "2022-03-14"},
      "updatedAt": "2026-01-21T13:40:12Z"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Work Orders

POST /work-orders: Create a work order with tasks, assignments, priority, and initial checklist.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/work-orders \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "title": "Investigate noise from AHU-03",
    "description": "Customer reports grinding noise during startup.",
    "priority": "high",
    "type": "corrective",
    "assetId": "ast_9f2c11",
    "locationId": "loc_northwing",
    "requestedBy": {"name": "Front Desk", "email": "[email protected]"},
    "dueDate": "2026-01-25",
    "assignedToUserIds": ["usr_tech_12", "usr_tech_34"],
    "checklist": [
      {"stepId": "chk_01", "text": "Lockout/Tagout applied", "required": true},
      {"stepId": "chk_02", "text": "Inspect fan bearings", "required": true},
      {"stepId": "chk_03", "text": "Record meter reading", "required": false}
    ],
    "attachments": [
      {"fileName": "noise_video.mp4", "uploadToken": "upl_71b2aa"}
    ],
    "referenceId": "zendesk-req-5839"
  }'

Example response

{
  "workOrderId": "wo_7b3182",
  "number": 10457,
  "status": "open",
  "priority": "high",
  "assetId": "ast_9f2c11",
  "createdAt": "2026-01-21T15:05:33Z"
}

PATCH /work-orders/{workOrderId}: Update status, add time/parts used, checklist results, and closure notes.

curl --request PATCH \
  --url https://api.supergood.ai/integrations/<integration_id>/work-orders/wo_7b3182 \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "status": "completed",
    "labor": [
      {"userId": "usr_tech_12", "hours": 1.5, "laborRate": 45.00, "startedAt": "2026-01-21T16:00:00Z"}
    ],
    "partsUsed": [
      {"partId": "prt_6201", "quantity": 2, "binId": "bin_main", "unitCost": 12.50}
    ],
    "checklistResults": [
      {"stepId": "chk_01", "value": true},
      {"stepId": "chk_02", "value": "Repacked bearings"},
      {"stepId": "chk_03", "value": {"meterId": "mtr_hrs", "reading": 12451}}
    ],
    "downtimeMinutes": 45,
    "resolutionNotes": "Bearing wear caused noise; replaced and tested.",
    "attachments": [
      {"fileName": "completion_photo.jpg", "uploadToken": "upl_4ba992"}
    ]
  }'

Example response

{
  "workOrderId": "wo_7b3182",
  "status": "completed",
  "closedAt": "2026-01-21T18:22:10Z",
  "costSummary": {"labor": 67.50, "parts": 25.00, "total": 92.50}
}

Preventive Maintenance Schedules

GET /pm-schedules: List PM schedules and next due dates (time- or meter-based) with optional filtering by asset and status.

Query parameters

  • assetId: string
  • status: active | paused | archived
  • type: time | meter | mixed
  • nextDueFrom, nextDueTo: ISO 8601 timestamps
  • page, pageSize: integers for pagination

Example response

{
  "items": [
    {
      "pmId": "pm_ah03_quarterly",
      "title": "AHU-03 Quarterly PM",
      "assetId": "ast_9f2c11",
      "type": "time",
      "frequency": {"intervalDays": 90},
      "generateMode": "fixed",
      "autoGenerateWO": true,
      "lastCompletionAt": "2025-11-01T10:05:00Z",
      "nextDueAt": "2026-01-30T00:00:00Z",
      "assignedToUserIds": ["usr_tech_12"],
      "checklistTemplateId": "chk_tpl_quarterly_ahu"
    }
  ],
  "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 assets, work orders, PM schedules, and inventory activity
  • Security: Encrypted transport, scoped tokens, and audit logging; respects Limble role-based permissions
  • Webhooks: Optional asynchronous delivery for long-running workflows (e.g., PM generation, WO status changes)

Performance Characteristics

  • Latency: Sub-second responses for list/detail queries under normal load
  • Throughput: Designed for high-volume WO data sync, PM monitoring, and inventory transaction 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 Limble adapter tailored to your workflows and entitlements.

  1. Deploy with Monitoring

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

Schedule Integration Call →


Frequently Asked Questions

Q: Which Limble modules can this integration cover?

Supergood supports workflows across commonly used modules such as Asset & Location Management, Work Management (Work Requests, Work Orders, Checklists), Preventive Maintenance (Time/Meter-based), and Inventory (Parts, Bins, Transactions), 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 inventory and costs to our accounting/ERP?

Yes. We can normalize parts issue/receive transactions and WO cost breakdowns to match your ERP/accounting schema (e.g., GL codes, cost centers) and deliver updates via webhooks or polling while complying with rate and permission constraints. We commonly integrate with QuickBooks and Xero.

Q: Do you support IoT-triggered work orders and meter updates?

Yes. We can ingest sensor alerts and meter readings, create WOs based on thresholds, and update meter values and PM compliance in near real time, with debouncing and idempotency controls.



Ready to automate your Limble CMMS workflows?

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

Get Started →

Read more