API - FacilityAI

Built for Developers

Everything you need to integrate FacilityAI into your existing workflows and applications

Secure by Default

Industry-standard OAuth 2.0 authentication with fine-grained API key permissions and role-based access control.

RESTful Design

Clean, predictable API endpoints following REST conventions with JSON request and response payloads.

Real-time Webhooks

Subscribe to events and receive instant notifications when assets change, work orders update, or alerts trigger.

Comprehensive Data

Full access to assets, work orders, maintenance history, sensor data, and AI-generated insights.

Rate Limit Friendly

Generous rate limits with clear headers. Batch endpoints available for high-volume operations.

Detailed Documentation

Interactive API reference with code examples, request builders, and comprehensive guides.

Simple & Intuitive

Get started in minutes with our straightforward API. Retrieve asset data, create work orders, and integrate AI insights with just a few lines of code.

JSON responses with consistent structure
Pagination, filtering, and sorting built-in
Versioned API for backward compatibility
Sandbox environment for testing

Get API Access

                        
                        
                        
                        get-assets.js
                    

// Fetch assets with AI health scores
const response = await fetch(
  'https://api.facilityai.com/v1/assets',
  {
    headers: {
      'Authorization': `Bearer ${API_KEY}`,
      'Content-Type': 'application/json'
    }
  }
);

const { data } = await response.json();

// Response includes AI-generated insights
data.assets.forEach(asset => {
  console.log(asset.name);
  console.log(asset.health_score);  // 0-100
  console.log(asset.predicted_maintenance);
});
                    

API Endpoints

Core endpoints for managing your facility operations programmatically

Assets

GET /v1/assets List all assets with filtering and pagination

GET /v1/assets/{id} Retrieve a specific asset with full details

POST /v1/assets Create a new asset

PUT /v1/assets/{id} Update an existing asset

Work Orders

GET /v1/work-orders List work orders with status filtering

POST /v1/work-orders Create a new work order

PUT /v1/work-orders/{id}/status Update work order status

AI Insights

GET /v1/insights/health-scores Get AI-calculated health scores for assets

GET /v1/insights/predictions Retrieve maintenance predictions and alerts

POST /v1/insights/analyze Request AI analysis for specific assets

Official SDKs

Native libraries for your favorite languages and frameworks

JavaScript

Node.js & Browser

Python

Python 3.8+

.NET

.NET 6+

Go

Go 1.18+

☕

Java

Java 11+

Developer API