UNISPHERE
  • Welcome to Unisphere Product Documentation
  • NOVA
    • Get started
      • Create an account
      • Create a new mission
      • Create your assets
      • Edit your Mission
      • Manage your profile
        • Settings
    • Mission types
      • Local-Flight
      • Multi-Location
      • Route
    • Assets
      • Aircraft Type
      • Performance Set
      • Limit Set
        • Limit thresholds types
        • Weather and Operational Parameters
      • Locations & Routes
    • Weather Stations
      • Connect
      • Overview
      • Individual View
      • Mission Integration
    • Mission results
      • NOW
        • Local-Flight
        • Multi-Location
        • Route
      • AWARE
        • Local-Flight
        • Multi-Location
        • Route
      • CAST
        • Local-Flight
        • Multi-Location
        • Route
      • Maps
    • Glossary
    • NOVA Release Log
  • OPERATIONAL ANALYTICS
    • Create your analysis
    • Manage your analysis
    • Analytics assets
    • Analysis types
      • Wind Analysis
      • Service Availability
      • Benchmark Analysis
    • Analysis results
      • Wind Analysis
      • Service Availability
      • Benchmark Analysis
      • Map Overview
  • UNISPHERE APIs
    • Introduction to Unisphere APIs
    • API Access
    • Flight Trajectory Simulation - FTS
      • FTS2 Endpoints
    • Check My Flight - CMF
      • CMF Endpoints
      • CMF Supporting Functions
    • Check My Mission - CMM
      • CMM Endpoints
      • CMM Supporting Functions
    • Data Storage & Logging
    • Asset Management Endpoints
    • API Key Management
    • Utilities & Health
    • Explanatory Notes
      • Available Parameters
      • Speeds
    • Geo Information Service
  • FAQ
Powered by GitBook
On this page

Was this helpful?

  1. UNISPHERE APIs
  2. Flight Trajectory Simulation - FTS

FTS2 Endpoints

PreviousFlight Trajectory Simulation - FTSNextCheck My Flight - CMF

Last updated 5 months ago

Was this helpful?

  • POSTPost Trajectory
  • GETGet Trajectory

Get Trajectory

get
Authorizations
Path parameters
simulation_idstringRequired
Query parameters
response_model_exclude_noneanyOptionalDefault: true
Responses
200
Successful Response
application/json
Responseany of
or
stringOptional
422
Validation Error
application/json
get
GET /flight-trajectory/v1/fts2/{simulation_id} HTTP/1.1
Host: 
x-api-key: YOUR_API_KEY
Accept: */*
{
  "simulation_id": "text",
  "simulation_request_time": "2025-05-22T15:23:15.778Z",
  "route_distance": 1,
  "zero_wind_flight_time": 1,
  "take_off_time": "2025-05-22T15:23:15.778Z",
  "flight_time": 1,
  "landing_time": "2025-05-22T15:23:15.778Z",
  "soc_at_take_off_percent": 1,
  "soc_at_landing_percent": 1,
  "endurance_at_take_off": 1,
  "endurance_at_landing": 1,
  "elevation_at_take_off": 1,
  "elevation_at_landing": 1,
  "metadata": {},
  "segments": [
    {
      "latitude": 1,
      "longitude": 1,
      "altitude": 1,
      "timeframe": "text",
      "status": "nominal",
      "speed_gs": {
        "value": 1,
        "unit": "text"
      },
      "speed_eas": {
        "value": 1,
        "unit": "text"
      },
      "weather_parameter": [
        {
          "name": "text",
          "value": 1,
          "unit": "text"
        }
      ]
    }
  ]
}

Post Trajectory

post
Authorizations
Body
take_offstring · date-timeRequired
battery_socnumber · max: 1Required
metadataany ofOptional
objectOptional
or
nullOptional
Responses
201
Successful Response
application/json
422
Validation Error
application/json
post
POST /flight-trajectory/v1/fts2 HTTP/1.1
Host: 
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 581

{
  "battery_soc": 0.958,
  "metadata": {
    "custom_fields": "custom_values"
  },
  "performance_parameters": [
    {
      "name": "cruise_speed",
      "type": "EAS",
      "unit": "m/s",
      "value": 30
    },
    {
      "name": "max_speed",
      "type": "EAS",
      "unit": "m/s",
      "value": 35
    },
    {
      "name": "rate_of_climb",
      "type": "TAS",
      "unit": "m/s",
      "value": 5
    },
    {
      "name": "rate_of_descent",
      "type": "TAS",
      "unit": "m/s",
      "value": 5
    },
    {
      "name": "endurance",
      "unit": "s",
      "value": 3600
    }
  ],
  "route": [
    {
      "altitude": 100,
      "altitude_type": "AGL",
      "latitude": 52.52,
      "longitude": 13.404
    },
    {
      "altitude": 100,
      "altitude_type": "AGL",
      "latitude": 52.525,
      "longitude": 13.405
    }
  ],
  "take_off": "2024-12-04T13:00:00+00:00"
}
{
  "simulation_id": "text"
}