{"openapi":"3.1.0","info":{"title":"PreFlight Mission Intelligence API","version":"1.0.0","description":"Granular aviation, weather, airspace, infrastructure, and mission-readiness products that can be sold independently or composed into a complete operational assessment."},"servers":[{"url":"https://raingentic.saibolla.com","description":"Current PreFlight API deployment"}],"tags":[{"name":"Aviation weather","description":"Weather observations, forecasts, pilot reports, advisories, and winds."},{"name":"FAA and airspace","description":"Airspace classifications, restrictions, notices, facility-map limits, and authorization requirements."},{"name":"Infrastructure","description":"Airports, obstacles, and terrain data."},{"name":"Operational awareness","description":"Traffic, GNSS, and operating-window intelligence."},{"name":"Mission intelligence","description":"Composite assessments built from the granular products."}],"paths":{"/api/preflight/weather/metars":{"get":{"operationId":"getMetars","summary":"METAR observations","description":"Returns decoded and raw aviation weather observations for one or more ICAO stations.","tags":["Aviation weather"],"parameters":[{"name":"station","in":"query","required":true,"description":"ICAO airport or weather station identifier.","schema":{"type":"string","pattern":"^[A-Z0-9]{3,4}$"},"example":"KJFK"}],"responses":{"200":{"description":"METAR observations response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request parameters"},"502":{"description":"An upstream data provider was unavailable"}},"x-raingentic-price":{"amount":"0.01","currency":"USD","unit":"request"},"x-raingentic-source-type":"aviation-weather-provider"}},"/api/preflight/weather/tafs":{"get":{"operationId":"getTafs","summary":"TAF forecasts","description":"Returns terminal aerodrome forecasts with forecast periods, winds, visibility, and cloud conditions.","tags":["Aviation weather"],"parameters":[{"name":"station","in":"query","required":true,"description":"ICAO airport or weather station identifier.","schema":{"type":"string","pattern":"^[A-Z0-9]{3,4}$"},"example":"KJFK"}],"responses":{"200":{"description":"TAF forecasts response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request parameters"},"502":{"description":"An upstream data provider was unavailable"}},"x-raingentic-price":{"amount":"0.015","currency":"USD","unit":"request"},"x-raingentic-source-type":"aviation-weather-provider"}},"/api/preflight/weather/pireps":{"get":{"operationId":"getPireps","summary":"Pilot reports","description":"Returns pilot reports near an operating area, including turbulence, icing, cloud, and visibility observations.","tags":["Aviation weather"],"parameters":[{"name":"latitude","in":"query","required":true,"description":"Latitude in decimal degrees.","schema":{"type":"number","minimum":-90,"maximum":90},"example":40.6413},{"name":"longitude","in":"query","required":true,"description":"Longitude in decimal degrees.","schema":{"type":"number","minimum":-180,"maximum":180},"example":-73.7781},{"name":"radiusNm","in":"query","required":false,"description":"Search radius in nautical miles.","schema":{"type":"number","minimum":1,"maximum":100,"default":10}}],"responses":{"200":{"description":"Pilot reports response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request parameters"},"502":{"description":"An upstream data provider was unavailable"}},"x-raingentic-price":{"amount":"0.02","currency":"USD","unit":"request"},"x-raingentic-source-type":"aviation-weather-provider"}},"/api/preflight/weather/sigmets":{"get":{"operationId":"getSigmets","summary":"SIGMET advisories","description":"Returns active significant meteorological advisories intersecting the requested operating area.","tags":["Aviation weather"],"parameters":[{"name":"latitude","in":"query","required":true,"description":"Latitude in decimal degrees.","schema":{"type":"number","minimum":-90,"maximum":90},"example":40.6413},{"name":"longitude","in":"query","required":true,"description":"Longitude in decimal degrees.","schema":{"type":"number","minimum":-180,"maximum":180},"example":-73.7781},{"name":"radiusNm","in":"query","required":false,"description":"Search radius in nautical miles.","schema":{"type":"number","minimum":1,"maximum":100,"default":10}}],"responses":{"200":{"description":"SIGMET advisories response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request parameters"},"502":{"description":"An upstream data provider was unavailable"}},"x-raingentic-price":{"amount":"0.02","currency":"USD","unit":"request"},"x-raingentic-source-type":"aviation-weather-provider"}},"/api/preflight/weather/conditions":{"get":{"operationId":"getWeatherConditions","summary":"Surface weather conditions","description":"Returns current temperature, wind, visibility, precipitation, ceiling, and flight category for a coordinate.","tags":["Aviation weather"],"parameters":[{"name":"latitude","in":"query","required":true,"description":"Latitude in decimal degrees.","schema":{"type":"number","minimum":-90,"maximum":90},"example":40.6413},{"name":"longitude","in":"query","required":true,"description":"Longitude in decimal degrees.","schema":{"type":"number","minimum":-180,"maximum":180},"example":-73.7781}],"responses":{"200":{"description":"Surface weather conditions response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request parameters"},"502":{"description":"An upstream data provider was unavailable"}},"x-raingentic-price":{"amount":"0.02","currency":"USD","unit":"request"},"x-raingentic-source-type":"aviation-weather-provider"}},"/api/preflight/weather/winds-aloft":{"get":{"operationId":"getWindsAloft","summary":"Winds aloft","description":"Returns forecast wind speed, direction, and temperature at multiple operating altitudes.","tags":["Aviation weather"],"parameters":[{"name":"latitude","in":"query","required":true,"description":"Latitude in decimal degrees.","schema":{"type":"number","minimum":-90,"maximum":90},"example":40.6413},{"name":"longitude","in":"query","required":true,"description":"Longitude in decimal degrees.","schema":{"type":"number","minimum":-180,"maximum":180},"example":-73.7781},{"name":"altitudeFeet","in":"query","required":false,"description":"Planned altitude above ground level in feet.","schema":{"type":"number","minimum":0,"maximum":20000,"default":400}}],"responses":{"200":{"description":"Winds aloft response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request parameters"},"502":{"description":"An upstream data provider was unavailable"}},"x-raingentic-price":{"amount":"0.03","currency":"USD","unit":"request"},"x-raingentic-source-type":"aviation-weather-provider"}},"/api/preflight/airspace/classes":{"get":{"operationId":"getAirspaceClasses","summary":"Airspace classes","description":"Returns controlled and special-use airspace intersecting the requested area, including floor and ceiling limits.","tags":["FAA and airspace"],"parameters":[{"name":"latitude","in":"query","required":true,"description":"Latitude in decimal degrees.","schema":{"type":"number","minimum":-90,"maximum":90},"example":40.6413},{"name":"longitude","in":"query","required":true,"description":"Longitude in decimal degrees.","schema":{"type":"number","minimum":-180,"maximum":180},"example":-73.7781},{"name":"radiusNm","in":"query","required":false,"description":"Search radius in nautical miles.","schema":{"type":"number","minimum":1,"maximum":100,"default":10}}],"responses":{"200":{"description":"Airspace classes response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request parameters"},"502":{"description":"An upstream data provider was unavailable"}},"x-raingentic-price":{"amount":"0.025","currency":"USD","unit":"request"},"x-raingentic-source-type":"faa-data-provider"}},"/api/preflight/airspace/tfrs":{"get":{"operationId":"getTemporaryFlightRestrictions","summary":"Temporary flight restrictions","description":"Returns active and scheduled temporary flight restrictions near the requested operation.","tags":["FAA and airspace"],"parameters":[{"name":"latitude","in":"query","required":true,"description":"Latitude in decimal degrees.","schema":{"type":"number","minimum":-90,"maximum":90},"example":40.6413},{"name":"longitude","in":"query","required":true,"description":"Longitude in decimal degrees.","schema":{"type":"number","minimum":-180,"maximum":180},"example":-73.7781},{"name":"radiusNm","in":"query","required":false,"description":"Search radius in nautical miles.","schema":{"type":"number","minimum":1,"maximum":100,"default":10}}],"responses":{"200":{"description":"Temporary flight restrictions response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request parameters"},"502":{"description":"An upstream data provider was unavailable"}},"x-raingentic-price":{"amount":"0.025","currency":"USD","unit":"request"},"x-raingentic-source-type":"faa-data-provider"}},"/api/preflight/airspace/notams":{"get":{"operationId":"getNotams","summary":"NOTAMs","description":"Returns notices to air missions affecting airports, navigation facilities, airspace, or hazards near the operation.","tags":["FAA and airspace"],"parameters":[{"name":"latitude","in":"query","required":true,"description":"Latitude in decimal degrees.","schema":{"type":"number","minimum":-90,"maximum":90},"example":40.6413},{"name":"longitude","in":"query","required":true,"description":"Longitude in decimal degrees.","schema":{"type":"number","minimum":-180,"maximum":180},"example":-73.7781},{"name":"radiusNm","in":"query","required":false,"description":"Search radius in nautical miles.","schema":{"type":"number","minimum":1,"maximum":100,"default":10}},{"name":"station","in":"query","required":true,"description":"ICAO airport or weather station identifier.","schema":{"type":"string","pattern":"^[A-Z0-9]{3,4}$"},"example":"KJFK"}],"responses":{"200":{"description":"NOTAMs response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request parameters"},"502":{"description":"An upstream data provider was unavailable"}},"x-raingentic-price":{"amount":"0.03","currency":"USD","unit":"request"},"x-raingentic-source-type":"faa-data-provider"}},"/api/preflight/airspace/laanc-facility-maps":{"get":{"operationId":"getLaancFacilityMaps","summary":"LAANC facility map limits","description":"Returns UAS facility map grid limits and the maximum altitude eligible for automated authorization review.","tags":["FAA and airspace"],"parameters":[{"name":"latitude","in":"query","required":true,"description":"Latitude in decimal degrees.","schema":{"type":"number","minimum":-90,"maximum":90},"example":40.6413},{"name":"longitude","in":"query","required":true,"description":"Longitude in decimal degrees.","schema":{"type":"number","minimum":-180,"maximum":180},"example":-73.7781}],"responses":{"200":{"description":"LAANC facility map limits response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request parameters"},"502":{"description":"An upstream data provider was unavailable"}},"x-raingentic-price":{"amount":"0.03","currency":"USD","unit":"request"},"x-raingentic-source-type":"faa-data-provider"}},"/api/preflight/airspace/authorization-requirements":{"get":{"operationId":"getAuthorizationRequirements","summary":"Authorization requirements","description":"Determines whether the proposed operation needs LAANC, DroneZone coordination, a waiver, or no airspace authorization.","tags":["FAA and airspace"],"parameters":[{"name":"latitude","in":"query","required":true,"description":"Latitude in decimal degrees.","schema":{"type":"number","minimum":-90,"maximum":90},"example":40.6413},{"name":"longitude","in":"query","required":true,"description":"Longitude in decimal degrees.","schema":{"type":"number","minimum":-180,"maximum":180},"example":-73.7781},{"name":"altitudeFeet","in":"query","required":false,"description":"Planned altitude above ground level in feet.","schema":{"type":"number","minimum":0,"maximum":20000,"default":400}}],"responses":{"200":{"description":"Authorization requirements response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request parameters"},"502":{"description":"An upstream data provider was unavailable"}},"x-raingentic-price":{"amount":"0.04","currency":"USD","unit":"request"},"x-raingentic-source-type":"faa-data-provider"}},"/api/preflight/airports/nearby":{"get":{"operationId":"getNearbyAirports","summary":"Nearby airports and heliports","description":"Returns airports, heliports, runways, and operational proximity relevant to the mission area.","tags":["Infrastructure"],"parameters":[{"name":"latitude","in":"query","required":true,"description":"Latitude in decimal degrees.","schema":{"type":"number","minimum":-90,"maximum":90},"example":40.6413},{"name":"longitude","in":"query","required":true,"description":"Longitude in decimal degrees.","schema":{"type":"number","minimum":-180,"maximum":180},"example":-73.7781},{"name":"radiusNm","in":"query","required":false,"description":"Search radius in nautical miles.","schema":{"type":"number","minimum":1,"maximum":100,"default":10}}],"responses":{"200":{"description":"Nearby airports and heliports response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request parameters"},"502":{"description":"An upstream data provider was unavailable"}},"x-raingentic-price":{"amount":"0.015","currency":"USD","unit":"request"},"x-raingentic-source-type":"preflight-derived-product"}},"/api/preflight/obstacles/nearby":{"get":{"operationId":"getNearbyObstacles","summary":"Nearby obstacles","description":"Returns towers, buildings, cranes, and other known vertical obstructions near the planned operation.","tags":["Infrastructure"],"parameters":[{"name":"latitude","in":"query","required":true,"description":"Latitude in decimal degrees.","schema":{"type":"number","minimum":-90,"maximum":90},"example":40.6413},{"name":"longitude","in":"query","required":true,"description":"Longitude in decimal degrees.","schema":{"type":"number","minimum":-180,"maximum":180},"example":-73.7781},{"name":"radiusNm","in":"query","required":false,"description":"Search radius in nautical miles.","schema":{"type":"number","minimum":1,"maximum":100,"default":10}}],"responses":{"200":{"description":"Nearby obstacles response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request parameters"},"502":{"description":"An upstream data provider was unavailable"}},"x-raingentic-price":{"amount":"0.02","currency":"USD","unit":"request"},"x-raingentic-source-type":"preflight-derived-product"}},"/api/preflight/terrain/elevation":{"get":{"operationId":"getTerrainElevation","summary":"Terrain elevation","description":"Returns ground elevation, route clearance, and terrain variation for the requested coordinate and altitude.","tags":["Infrastructure"],"parameters":[{"name":"latitude","in":"query","required":true,"description":"Latitude in decimal degrees.","schema":{"type":"number","minimum":-90,"maximum":90},"example":40.6413},{"name":"longitude","in":"query","required":true,"description":"Longitude in decimal degrees.","schema":{"type":"number","minimum":-180,"maximum":180},"example":-73.7781},{"name":"altitudeFeet","in":"query","required":false,"description":"Planned altitude above ground level in feet.","schema":{"type":"number","minimum":0,"maximum":20000,"default":400}}],"responses":{"200":{"description":"Terrain elevation response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request parameters"},"502":{"description":"An upstream data provider was unavailable"}},"x-raingentic-price":{"amount":"0.01","currency":"USD","unit":"request"},"x-raingentic-source-type":"preflight-derived-product"}},"/api/preflight/traffic/nearby":{"get":{"operationId":"getNearbyTraffic","summary":"Nearby cooperative traffic","description":"Returns recent cooperative aircraft activity, distance, altitude, heading, and trend near the operation.","tags":["Operational awareness"],"parameters":[{"name":"latitude","in":"query","required":true,"description":"Latitude in decimal degrees.","schema":{"type":"number","minimum":-90,"maximum":90},"example":40.6413},{"name":"longitude","in":"query","required":true,"description":"Longitude in decimal degrees.","schema":{"type":"number","minimum":-180,"maximum":180},"example":-73.7781},{"name":"radiusNm","in":"query","required":false,"description":"Search radius in nautical miles.","schema":{"type":"number","minimum":1,"maximum":100,"default":10}}],"responses":{"200":{"description":"Nearby cooperative traffic response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request parameters"},"502":{"description":"An upstream data provider was unavailable"}},"x-raingentic-price":{"amount":"0.05","currency":"USD","unit":"request"},"x-raingentic-source-type":"preflight-derived-product"}},"/api/preflight/gnss/integrity":{"get":{"operationId":"getGnssIntegrity","summary":"GNSS integrity","description":"Returns predicted satellite availability, dilution of precision, reliability, and expected navigation outages.","tags":["Operational awareness"],"parameters":[{"name":"latitude","in":"query","required":true,"description":"Latitude in decimal degrees.","schema":{"type":"number","minimum":-90,"maximum":90},"example":40.6413},{"name":"longitude","in":"query","required":true,"description":"Longitude in decimal degrees.","schema":{"type":"number","minimum":-180,"maximum":180},"example":-73.7781},{"name":"startTime","in":"query","required":false,"description":"ISO 8601 mission start time.","schema":{"type":"string","format":"date-time"}},{"name":"endTime","in":"query","required":false,"description":"ISO 8601 mission end time.","schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"GNSS integrity response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request parameters"},"502":{"description":"An upstream data provider was unavailable"}},"x-raingentic-price":{"amount":"0.02","currency":"USD","unit":"request"},"x-raingentic-source-type":"preflight-derived-product"}},"/api/preflight/daylight/windows":{"get":{"operationId":"getDaylightWindows","summary":"Daylight operating windows","description":"Returns civil twilight, sunrise, sunset, and night-operation windows for the location and date.","tags":["Operational awareness"],"parameters":[{"name":"latitude","in":"query","required":true,"description":"Latitude in decimal degrees.","schema":{"type":"number","minimum":-90,"maximum":90},"example":40.6413},{"name":"longitude","in":"query","required":true,"description":"Longitude in decimal degrees.","schema":{"type":"number","minimum":-180,"maximum":180},"example":-73.7781},{"name":"date","in":"query","required":false,"description":"Calendar date for the operating window.","schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"Daylight operating windows response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request parameters"},"502":{"description":"An upstream data provider was unavailable"}},"x-raingentic-price":{"amount":"0.005","currency":"USD","unit":"request"},"x-raingentic-source-type":"preflight-derived-product"}},"/api/preflight/mission/readiness":{"post":{"operationId":"createMissionReadinessAssessment","summary":"Mission readiness assessment","description":"Combines selected weather, FAA, airspace, terrain, obstacle, traffic, GNSS, and aircraft constraints into one explainable assessment.","tags":["Mission intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MissionRequest"}}}},"responses":{"200":{"description":"Mission readiness assessment response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request parameters"},"502":{"description":"An upstream data provider was unavailable"}},"x-raingentic-price":{"amount":"0.25","currency":"USD","unit":"assessment"},"x-raingentic-source-type":"preflight-derived-product"}}},"components":{"schemas":{"MissionRequest":{"type":"object","required":["latitude","longitude","plannedAltitudeFeet","startTime","endTime"],"properties":{"latitude":{"type":"number","minimum":-90,"maximum":90},"longitude":{"type":"number","minimum":-180,"maximum":180},"plannedAltitudeFeet":{"type":"number","minimum":0,"maximum":20000},"startTime":{"type":"string","format":"date-time"},"endTime":{"type":"string","format":"date-time"},"aircraft":{"type":"object","additionalProperties":true},"requiredProducts":{"type":"array","items":{"type":"string"}}}}}}}