Quick Start

Get up and running with the Trakt API in minutes

Authentication

All API requests require authentication using your company API key.

curl 
curl -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     https://api.trakt.com/v1/health-check
Replace YOUR_API_KEY with your actual API key from the dashboard.

Base URL

All API endpoints are accessed via the base URL:

https://api.trakt.com/v1/

Rate Limits

Basic 1,000 requests/month
Professional 5,000 requests/month
Enterprise 50,000 requests/month

API Endpoints

Complete reference for all available endpoints

GET

Health Check

Endpoint: /api/health-check
Check API service status and your authentication.

Response Example

json 
{
  "status": "healthy",
  "timestamp": "2025-01-01T12:00:00Z",
  "version": "1.0.0",
  "authenticated": true,
  "company": "Demo Airlines",
  "rate_limit": {
    "remaining": 4950,
    "total": 5000,
    "reset_time": "2025-01-01T13:00:00Z"
  }
}
GET

Model Status

Endpoint: /api/models/status
Get current AI model training status and performance metrics.

Response Example

json 
{
  "model_info": {
    "model_trained": true,
    "last_training_date": "2025-01-01T08:00:00Z",
    "training_data_count": 15420,
    "auto_training_enabled": true,
    "new_samples_count": 45
  },
  "physics_engine_status": {
    "available_models": ["weibull", "paris_erdogan", "arrhenius"],
    "calibrated_components": 156
  },
  "specialized_models_status": {
    "anomaly_detection": "ready",
    "failure_prediction": "ready",
    "survival_analysis": "ready",
    "maintenance_optimization": "ready"
  }
}
GET

Aircraft List

Endpoint: /api/aircraft
Retrieve all aircraft in your fleet with basic information.

Query Parameters

limit (optional) Maximum number of results (default: 50)
offset (optional) Pagination offset (default: 0)
active_only (optional) Filter for active aircraft only (default: true)

Response Example

json 
{
  "aircraft": [
    {
      "id": 1,
      "tail_number": "N123DA",
      "aircraft_type": "Boeing 737-800",
      "manufacturer": "Boeing",
      "model": "737-800",
      "year_manufactured": 2015,
      "total_flight_hours": 25000,
      "total_flight_cycles": 15000,
      "is_active": true,
      "component_count": 6,
      "average_health_score": 78.5,
      "critical_components": 1
    }
  ],
  "total_count": 1,
  "pagination": {
    "limit": 50,
    "offset": 0,
    "has_more": false
  }
}
POST

Component Analysis

Endpoint: /api/components/{component_id}/analyze
Run comprehensive AI analysis on a specific component.

Request Body Example

json 
{
  "sensor_data": {
    "temperature": 85.5,
    "vibration": 2.3,
    "pressure": 42.1,
    "rpm": 12500,
    "oil_temperature": 88.2,
    "fuel_flow": 55.0,
    "voltage": 28.5,
    "current": 15.2
  }
}

Response Example

json 
{
  "success": true,
  "analysis": {
    "component_id": 1,
    "component_name": "Engine #1",
    "component_type": "Engine",
    "aircraft": "N123DA",
    "physics_based": {
      "model_type": "weibull",
      "predicted_rul_hours": 2450.5,
      "current_health": 76.2,
      "condition_indicator": 0.24,
      "failure_probability": 0.15
    },
    "ensemble_prediction": {
      "predicted_rul": 2520.0,
      "confidence": 0.87,
      "uncertainty": 0.13
    },
    "operational_intelligence": {
      "anomaly_detected": false,
      "anomaly_score": 0.12,
      "failure_probability": 0.15,
      "optimal_maintenance_action": "inspect",
      "maintenance_urgency": "MEDIUM"
    },
    "recommendations": [
      "Component operating normally - continue monitoring",
      "Schedule inspection within 45 days based on RUL prediction"
    ]
  },
  "timestamp": "2025-01-01T12:00:00Z"
}
POST

Add Sensor Data

Endpoint: /api/sensor-data
Submit new sensor readings for a component.

Request Body Example

json 
{
  "component_id": 1,
  "timestamp": "2025-01-01T12:00:00Z",
  "sensor_data": {
    "temperature": 85.5,
    "vibration": 2.3,
    "pressure": 42.1,
    "rpm": 12500,
    "oil_temperature": 88.2,
    "fuel_flow": 55.0,
    "voltage": 28.5,
    "current": 15.2
  }
}

Response Example

json 
{
  "success": true,
  "message": "Sensor data recorded successfully",
  "sensor_data_id": 12345,
  "auto_analysis_triggered": true,
  "timestamp": "2025-01-01T12:00:00Z"
}

Integration APIs

APIs for integrating with external maintenance systems

AMOS Integration

POST /api/integrations/amos/config Configure AMOS Connection
POST /api/integrations/amos/test Test AMOS Connection
POST /api/integrations/amos/sync Sync with AMOS
Supports SFTP, REST API, and SOAP connections

TRAX Integration

POST /api/integrations/trax/config Configure TRAX Connection
POST /api/integrations/trax/test Test TRAX Connection
POST /api/integrations/trax/sync Sync with TRAX
Supports eMRO, eMobility, and Legacy API

Error Codes

Complete reference for API error responses

Status Code Error Type Description Example Response
200 Success Request completed successfully {"success": true, "data": {...}}
400 Bad Request Invalid request parameters {"error": "Missing required field: component_id"}
401 Unauthorized Invalid or missing API key {"error": "Invalid API key"}
403 Forbidden Insufficient permissions {"error": "Admin access required"}
404 Not Found Resource not found {"error": "Component not found"}
429 Rate Limited Too many requests {"error": "Rate limit exceeded", "retry_after": 3600}
500 Server Error Internal server error {"error": "Internal server error"}