Integrations

FacilIQ API Capabilities

The FacilIQ API enables secure, scalable integration with third-party systems across accounting, ERP, maintenance, vendor management, insurance and claims, inspections, compliance, access control, and tenant or lease management platforms.

By synchronizing operational, financial, compliance, and asset data across systems, the API provides:

• Centralized portfolio visibility
• Cross-system reconciliation and reporting
• Automated workflows and notifications
• Reduced manual data entry and error rates
• Real-time operational oversight

The API is designed for enterprise portfolios, multi-entity ownership structures, and complex property hierarchies.

Outbound Data (FacilIQ → External Systems)

FacilIQ provides structured, normalized data to downstream systems for reporting, reconciliation, analytics, and operational processing.

1. Portfolio & Property Data

Master Data

• Portfolio and ownership groups
• Property records
• Unit-level data
• Site hierarchies

Metadata & Attributes

• Geographic information (region, market, address, geolocation)
• Asset classifications and types
• Building systems and specifications
• Square footage, capacity, structural attributes
• Ownership entities and reporting groups

Hierarchical Relationships

• Portfolio → Region → Property → Unit
• Multi-entity ownership mappings
• Cross-property associations

2. Work Orders & Repairs

• Open work orders (status, priority, assignments)
• Historical work order archive
• Labor, material, and vendor cost breakdowns
• SLA tracking and completion timestamps
• Linked documentation (photos, invoices, notes)
• Category and trade classifications

3. Incidents

• Incident type and classification
• Date, time, and location
• Severity and status
• Linked work orders or follow-up tasks
• Supporting documentation
• Investigation and resolution details

4. Audits & Compliance

• Audit records by property, unit, or scope
• Inspection results and scoring
• Findings and corrective actions
• Assigned responsibility
• Due dates and completion status
• Compliance tracking history

5. Contractors & Vendors

• Vendor master records
• Trade classifications and specialties
• Contact information
• Insurance certificates and expiration dates
• Licensing data
• Agreements and contract documents
• Linked invoices, work history, and performance data

6. Capital Expenditures (CAPEX)

• Project records and tracking
• Budget allocations
• Approval workflows and milestones
• Spend-to-date
• Variance reporting
• Funding sources and ownership mapping

7. Financial & Billing Data

• Invoice records and metadata
• Payment status and history
• General ledger coding references
• Entity and ownership mapping
• Billing source identifiers
• Reconciliation-ready export fields

8. Documents & Attachments

• Document metadata
• Secure file retrieval endpoints
• Association to properties, units, work orders, audits, vendors, or CAPEX
• Generated reports (PDF, CSV, structured export formats)

Inbound Data (External Systems → FacilIQ)

The FacilIQ API supports creation, updates, and event-driven triggers from external systems.

1. Work Orders & Repairs

• Create new work orders
• Update status, priority, or assignment
• Submit cost updates
• Mark completion
• Add notes or attachments

2. Incidents

• Submit new incident reports
• Update status
• Add follow-up actions
• Close or escalate incidents

3. Audits & Compliance

• Submit inspection results
• Upload findings
• Update remediation status
• Close corrective actions

4. Contractors & Vendors

• Create or update vendor master records
• Submit updated certifications or insurance
• Link agreements or compliance documents

5. Capital Expenditures

• Create new CAPEX projects
• Submit budget revisions
• Update approvals
• Push spend updates or milestone completions

6. External System Events

FacilIQ supports inbound event-driven integrations, including:

• Accounting events (invoice approval, payment issued)
• Maintenance system updates
• Access control or security alerts
• IoT or building system triggers
• Compliance notifications

External events can:

• Trigger automated workflows
• Generate alerts or tasks
• Update records
• Launch conditional logic

Technical Architecture

Protocol & Format

• HTTPS-only secure transport
• RESTful architecture (resource-based endpoints)
• JSON request and response payloads
• Consistent naming conventions and structured schemas
• Idempotent operations where applicable (PUT/PATCH)

Record Identification

• Globally unique, stable record IDs
• Cross-reference fields for third-party system IDs
• Referential integrity across related entities

Query & Data Access

• Filterable endpoints (date range, property, status, ownership group, etc.)
• Pagination support (limit/offset or cursor-based)
• Sorting and field selection options
• Incremental sync via last-modified timestamps
• Bulk export capabilities for large portfolios

Versioning

• Versioning via URL path or request header
• Backward compatibility guarantees within supported versions
• Deprecation timelines with advance notice

Security & Governance

Authentication & Authorization

• OAuth 2.0 (client credentials flow for server-to-server integration)
• API key support (where applicable)
• Token-based authentication with expiration
• No credentials transmitted via URL

Access Control

• Organization-scoped access
• Portfolio-level segmentation
• Role-based permissions
• Granular capability controls (read-only vs read/write per module)

Data Protection

• TLS encryption for data in transit
• Secure document retrieval endpoints
• Audit logging of API activity
• Rate limiting and abuse protection
• IP allowlisting (optional)

Enterprise Readiness

• Scalable for multi-entity and multi-portfolio organizations
• Designed for ERP-grade reconciliation
• Supports automation-first architecture
• Enables real-time and batch integrations
• Structure for compliance and audit traceability