Cryotos

Supergood | Cryotos API

Alex Klarfeld

Alex Klarfeld

— 7 min read
Supergood | Cryotos API

Programmatically access Cryotos maintenance work orders, assets, preventive maintenance plans, inventory movements, and approvals with a stable REST API. Supergood builds and operates production-grade, unofficial Cryotos integrations so your team can automate field and back-office processes without heavy custom engineering.

Plain English: Cryotos is cloud-based CMMS (Computerized Maintenance Management System) software used by facilities, manufacturing, and service teams to manage work orders, assets, preventive maintenance schedules, inspections, spare parts, vendors, and mobile field operations. An unofficial API lets you programmatically pull work orders, assets, locations, PM plans, technicians, parts, meter readings, and documents—and push new records or updates back into Cryotos.

For a tech company integrating with Cryotos, this means you can ingest real-time maintenance and asset data to power dashboards, sync work orders and parts consumption to ERP/accounting (e.g., SAP, Oracle NetSuite, Microsoft Dynamics 365, QuickBooks), automate work order creation from IoT alerts or ITSM tickets (e.g., ServiceNow), enrich your product with asset hierarchies, checklists, and photos, and orchestrate approvals, SLAs, and compliance workflows across systems.

What is Cryotos?

Cryotos (https://www.cryotos.com/) is a modern CMMS platform that centralizes maintenance operations across sites, assets, technicians, and vendors. Teams use Cryotos to create and dispatch work orders, plan preventive maintenance, track asset lifecycle and meter readings, manage spare parts and inventory, run inspections via mobile checklists, and coordinate approvals—all with role-based access and mobile-first execution.

Core product areas include:

  • Work Order Management (Requests, Dispatch, Status, SLA, Labor/Time, Photos/Documents)
  • Asset & Facility Management (Asset Registry, Locations, Hierarchies, Warranty, Criticality)
  • Preventive Maintenance (PM Plans, Calendar/Meter-Based Triggers, Task Templates)
  • Inventory & Parts (Stock Items, Reservations, Consumption, Reorder Thresholds)
  • Approvals & Compliance (Role-Based Approvals, E-Signatures, Audit Trails)
  • Mobile Field Service (Technician App, QR/Barcode Scan, Offline, Geotagged Updates)
  • Checklists & Inspections (Task Steps, Required Fields, Safety/Compliance Forms)
  • Vendor/Contractor Management (Assignments, Service-Level Tracking, Portal)
  • Reporting & Analytics (KPIs, MTTR/MTBF, Asset Health, Cost Tracking)

Common data entities:

  • Organizations, Sites, Locations
  • Users/Technicians, Roles/Permissions
  • Assets/Equipment (metadata, status, criticality, meter types)
  • Work Orders (category, priority, status, SLA, tasks, parts, attachments)
  • Preventive Maintenance Plans (frequency, triggers, task templates)
  • Parts/Inventory (stock items, bins, reservations, consumption)
  • Vendors/Contractors (contacts, agreements)
  • Checklists/Inspection Records (steps, results, signatures)
  • Time Entries/Labor (hours, cost codes)
  • Documents/Photos (uploads, links)
  • Meter Readings/Calibration Records

The Cryotos Integration Challenge

Maintenance teams depend on Cryotos daily, but turning portal-first workflows into API-driven automation isn’t trivial:

  • Role-aware portals: Technicians, supervisors, and vendors each see different fields, actions, and approval states
  • Asset hierarchies: Sites, locations, and parent/child assets complicate context and filtering
  • PM generation logic: Calendar and meter-based triggers produce work orders with nuanced timing and entitlements
  • Attachment-heavy records: Photos, videos, and PDFs require signed uploads, hashing, and lifecycle management
  • Inventory rigor: Parts reservations, consumption, and reorder points must be modeled consistently with traceability
  • Authentication & sessions: SSO/MFA and mobile-oriented session flows make headless automation complex
  • Data export pain: Teams report manual CSV exports, limited webhooks, or extra-cost API tiers that slow automation

How Supergood Creates Cryotos APIs

Supergood reverse-engineers authenticated browser and mobile flows to deliver a resilient API layer for your Cryotos 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

Maintenance & Asset Data Sync

  • Mirror sites, assets, and work orders into your internal data warehouse/analytics
  • Keep asset metadata and meter readings current for dashboards and reliability engineering
  • Normalize statuses, priorities, and categories across multi-site operations

Automated Work Order Creation & Routing

  • Generate work orders from IoT alerts, BMS/SCADA signals, or ITSM tickets (e.g., ServiceNow)
  • Auto-assign by site, asset type, skill, or vendor with SLA-aware due dates
  • Attach sensor snapshots, logs, and safety checklists

Preventive Maintenance & Meter-Based Scheduling

  • Sync PM plans and next-due dates to planning tools
  • Post meter readings programmatically to trigger PM work order creation
  • Track completion and variance for compliance and audits

Inventory & Financial Sync

  • Record parts reservations/consumption and reconcile with ERP/accounting (e.g., SAP, NetSuite, Dynamics, QuickBooks)
  • Push vendor bills or labor/time entries downstream for cost tracking
  • Maintain reorder points and stock availability across locations

Field Reporting & Compliance

  • Ingest technician notes, time entries, and photo attachments
  • Enforce checklist completion and approval gates from your product
  • Drive SLA alerts, escalations, and customer notifications

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

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

  • siteId: string
  • assetId: string
  • status: open | in_progress | awaiting_approval | completed | canceled
  • priority: low | medium | high | critical
  • updatedFrom, updatedTo: ISO 8601 timestamps
  • page, pageSize: integers for pagination

Example response

{
  "items": [
    {
      "workOrderId": "wo_3d92af",
      "code": "WO-2026-1142",
      "title": "HVAC Compressor Inspection",
      "description": "Quarterly inspection and cleaning of compressor unit.",
      "siteId": "site_north_01",
      "siteName": "North Plant",
      "assetId": "asset_hvac_8821",
      "assetTag": "HVAC-88-21",
      "category": "preventive_maintenance",
      "priority": "medium",
      "status": "open",
      "slaDueAt": "2026-02-05T23:59:59Z",
      "requestedByUserId": "u_cryo_1ab232",
      "assignedToUserId": "u_cryo_tech_9912",
      "checklistCount": 5,
      "partsReserved": 2,
      "attachments": 1,
      "createdAt": "2026-01-20T09:12:44Z",
      "updatedAt": "2026-01-21T12:30:10Z"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

POST /work-orders: Create a new work order with optional checklist and parts reservations.

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 Belt on Packaging Line",
    "description": "Belt showing fraying; replace and test tension.",
    "siteId": "site_packaging_02",
    "assetId": "asset_conv_4410",
    "category": "corrective_maintenance",
    "priority": "high",
    "dueDate": "2026-01-25",
    "requestedByUserId": "u_cryo_ops_311",
    "assignedToUserId": "u_cryo_tech_774",
    "checklist": [
      {"stepCode": "CHK-001", "text": "Lockout/tagout applied", "required": true},
      {"stepCode": "CHK-002", "text": "Remove damaged belt", "required": true},
      {"stepCode": "CHK-003", "text": "Install new belt and set tension", "required": true},
      {"stepCode": "CHK-004", "text": "Run test for 10 minutes", "required": true}
    ],
    "partsReserved": [
      {"partId": "part_belt_125A", "quantity": 1, "uom": "ea"},
      {"partId": "part_cleaner_02", "quantity": 1, "uom": "bottle"}
    ],
    "attachments": [
      {"fileName": "belt_spec.pdf", "uploadToken": "upl_6e21f9"}
    ],
    "notifyAssignee": true,
    "referenceId": "itsm-req-48291"
  }'

Example response

{
  "workOrderId": "wo_7fa210",
  "code": "WO-2026-1189",
  "status": "awaiting_approval",
  "createdAt": "2026-01-21T14:02:31Z"
}

Assets

GET /assets: List assets with location, meter, and lifecycle metadata.

Query parameters

  • siteId: string
  • status: active | inactive | retired
  • criticality: low | medium | high
  • updatedFrom, updatedTo: ISO 8601 timestamps
  • page, pageSize: integers for pagination

Example response

{
  "items": [
    {
      "assetId": "asset_hvac_8821",
      "name": "Compressor Unit A",
      "tag": "HVAC-88-21",
      "serialNumber": "CMP-99231-A",
      "category": "HVAC",
      "siteId": "site_north_01",
      "locationPath": "North Plant > Building 2 > Roof",
      "status": "active",
      "criticality": "high",
      "commissionedAt": "2023-05-01",
      "warrantyExpiresAt": "2028-05-01",
      "lastServiceAt": "2026-01-10",
      "meterType": "hours",
      "meterReading": {"value": 1420, "unit": "h"},
      "customFields": {"manufacturer": "ThermoAir", "model": "TA-4000"},
      "updatedAt": "2026-01-20T08:45:12Z"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Meter Readings

POST /assets/{assetId}/meter-readings: Record a meter reading that may trigger PM scheduling.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/assets/asset_hvac_8821/meter-readings \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "readingValue": 1440,
    "unit": "h",
    "readingAt": "2026-01-21T16:45:00Z",
    "source": "manual",
    "notes": "Technician recorded after inspection."
  }'

Example response

{
  "readingId": "mr_9120bd",
  "assetId": "asset_hvac_8821",
  "meterType": "hours",
  "readingValue": 1440,
  "unit": "h",
  "readingAt": "2026-01-21T16:45:00Z",
  "pmWorkOrderId": null,
  "nextDueAt": "2026-04-21T00:00:00Z"
}

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 plans, inventory, and approvals
  • Security: Encrypted transport, scoped tokens, and audit logging; respects Cryotos role-based permissions
  • Webhooks: Optional asynchronous delivery for long-running workflows (e.g., approvals, PM generation)

Performance Characteristics

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

  1. Deploy with Monitoring

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

Schedule Integration Call →

Frequently Asked Questions

Q: Which Cryotos modules can this integration cover?

Supergood supports workflows across commonly used modules such as Work Orders, Assets, Preventive Maintenance Plans, Inventory/Parts, Vendors, and Approvals, 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 parts consumption and work orders to our ERP/accounting system?

Yes. We can normalize parts reservations/consumption, labor/time entries, and vendor data to match your ERP/accounting schema (e.g., SAP, Oracle NetSuite, Microsoft Dynamics 365, QuickBooks) and deliver updates via webhooks or polling while complying with rate and permission constraints.

Q: Do you support meter-based PM scheduling and approvals?

Yes. We can ingest and post meter readings, reflect PM next-due calculations, and manage approval states, signatures, and artifacts with signed uploads and time-limited URLs.

Ready to automate your Cryotos workflows?

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

Get Started →

Read more