Home Features Pricing Integrations API Login Request Access
Developer Tools

FacilityAI REST API

Build powerful integrations with our comprehensive REST API. Manage assets, create work orders, access analytics, and sync data across your facility management ecosystem.

Getting Started

API Overview

A modern, RESTful API with comprehensive documentation and SDK support in multiple languages.

API Key Authentication

Secure your API requests with simple API key-based authentication. Generate keys in your dashboard and include them in request headers.

Learn more

RESTful Design

Standard HTTP methods (GET, POST, PUT, DELETE) with JSON request/response format. Intuitive resource-oriented endpoints for all operations.

Explore endpoints

Rate Limiting

1,000 requests per minute with clear rate limit headers. Monitor your usage and scale as needed with our tiered API plans.

View details

Webhooks

Real-time event notifications for asset creation, updates, and work order changes. Automatically sync data across your systems.

Configure webhooks
Quick Example

List Assets

Here's a simple example of fetching a list of assets from your facility.

GET https://api.facilityai.com/v1/assets 
// Request Headers
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

// Response Example
{
  "status": "success",
  "data": [
    {
      "id": "ast_abc123xyz",
      "name": "HVAC Unit - Floor 3",
      "type": "hvac",
      "manufacturer": "Carrier",
      "model": "AquaEdge 19DV",
      "location_id": "loc_def456",
      "install_date": "2018-05-15",
      "health_score": 72,
      "estimated_replacement_cost": 18500,
      "status": "active",
      "created_at": "2024-01-10T14:32:00Z"
    }
  ],
  "pagination": {
    "total": 342,
    "limit": 50,
    "offset": 0
  }
}
API Reference

Key Endpoints

Essential endpoints for managing assets, locations, work orders, and analytics.

GET /assets
List all assets across your portfolio with optional filtering by location, type, or health score.
POST /assets
Create a new asset with photos, nameplate data, and custom fields. Returns asset profile with AI-extracted specifications.
PUT /assets/{id}
Update an existing asset's details including location, condition notes, and maintenance history.
GET /locations
Retrieve all facility locations with aggregate data including total asset count, portfolio health, and replacement budget.
POST /work-orders
Create work orders for maintenance or replacement. Integrates with your CMMS and work order management systems.
GET /analytics/spend
Get AI-powered spend predictions with 10-year capital replacement plans, health scores, and budgeting recommendations by asset type.
Developer SDKs

Official Libraries

Use our official SDKs to integrate FacilityAI into your application with less code.

Python

Fully typed Python SDK with async/await support. Install via pip and start making requests in minutes.

View on GitHub

JavaScript / Node.js

Modern ES6+ SDK with TypeScript definitions. Works in Node.js and browsers with fetch-based HTTP client.

View on GitHub

Ruby

Ruby gem with Rails integration. Easily integrate with your Rails applications and access FacilityAI data.

View on GitHub

Go

High-performance Go client library with full API coverage. Perfect for backend services and CLI tools.

View on GitHub

Ready to Build?

Access our comprehensive API documentation, explore interactive examples, and get started building with FacilityAI today.

Request API Access Read Full Documentation

Request API Access

Get access to our REST API and start building integrations with FacilityAI. Our team will review your request and provide API keys within 24 hours.

Back Home