canonical: https://jentic.com/apis/ljaero.com/dflight

# Ljaero DFlight API

DFlight supplies UAV and drone operators with the airspace, weather, restriction, and surface-obstacle data required for preflight compliance assessment. Operators define an area of interest as a point with radius, a GeoJSON LineString route, or an arbitrary GeoJSON Polygon, and DFlight returns airspace classifications, special security areas, restricted public venues, surface obstacles, aerodromes, UAS operating areas, and weather forecasts that intersect that geometry. The API is organised by data category, with three query shapes per category (distance, route, polygon) for predictable integration into flight-planning tools.

## For AI agents

Query US airspace, weather, temporary flight restrictions, surface obstacles, and aerodrome data for any drone flight area defined as a point, route, or polygon.

## Scope

Does not handle drone fleet management, flight logging, or remote ID broadcast - use for UAV preflight airspace and hazard data queries only.

## Capabilities

- Query airspace classifications around a point, along a route, or inside a polygon for UAV preflight assessment
- Retrieve temporary flight restrictions and special security areas that intersect a planned flight path
- Pull weather forecasts for a defined drone operating area before takeoff
- Identify restricted public venues, surface obstacles, and aerodromes inside a planned UAS operating area
- Resolve UAS Operating Areas that overlap with a GeoJSON polygon or LineString
- Submit GeoJSON Polygon or LineString geometry to receive intersecting hazard data in a single call

## Use cases

### UAV Preflight Compliance Check

Drone operators must confirm before every flight that no temporary flight restrictions, special security areas, or restricted public venues exist in their planned operating area. DFlight accepts a point and radius, a route LineString, or an arbitrary polygon and returns all intersecting airspace, restriction, and venue records in a single call. This replaces stitching together FAA NOTAMs, sectional charts, and TFR feeds manually.

Example prompt: Submit a polygon covering a 2km square over downtown to /us/v1/restrictions/polygon-query and /us/v1/ssa/polygon-query and return any active TFRs or special security areas.

### Route Hazard Briefing

For longer drone missions defined as a flight path, DFlight evaluates a GeoJSON LineString against weather, obstacles, aerodromes, and UAS operating areas along the route. Operators get a single hazard briefing covering forecast wind and visibility, towers and other surface obstacles, nearby airports, and conflicting UOAs. This is meant to be embedded into flight-planning software so the briefing runs automatically when a route is drawn.

Example prompt: Send the planned LineString to /us/v1/wx-forecast/route-query, /us/v1/obstacles/route-query, and /us/v1/aerodromes/route-query and produce a consolidated hazard report.

### AI Agent Drone Mission Planner

An AI agent planning a drone delivery or inspection mission needs to programmatically validate the route against multiple authoritative datasets. Through Jentic, the agent searches for the relevant DFlight operations, loads their schemas, and submits the user's polygon or route, then summarises any hazards back to the user in natural language. This removes the need for the agent to hold DFlight credentials or browse documentation.

Example prompt: Use Jentic to query DFlight polygon endpoints for airspace, restrictions, and weather over a delivery zone polygon and return a go/no-go decision.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | /us/v1/airspace/polygon-query | Query airspace inside a GeoJSON polygon |
| POST | /us/v1/restrictions/route-query | Get TFRs intersecting a route LineString |
| POST | /us/v1/wx-forecast/distance-query | Forecast around a point and radius |
| POST | /us/v1/obstacles/polygon-query | Surface obstacles inside a polygon |
| POST | /us/v1/aerodromes/route-query | Aerodromes along a route |
| POST | /us/v1/uoa/polygon-query | UAS Operating Areas inside a polygon |

## Key resources

- **Airspace** — Query airspace classifications by distance, route, or polygon
- **Weather Forecast** — Retrieve forecasts for a defined operating area
- **Restrictions** — Look up temporary flight restrictions intersecting a geometry
- **Special Security Areas** — Identify SSAs along a route or inside a polygon
- **Restricted Public Venues** — Find restricted venues that intersect a flight area
- **Surface Obstacles** — Detect towers and other obstacles relevant to UAV flight
- **Aerodromes** — Locate airports and aerodromes near a planned mission
- **UAS Operating Areas** — Resolve UOAs intersecting a polygon or route

## Why Jentic

- **Setup:** Wiring the DFlight API by hand means targeting its dflight-api.ljaero.com host, shaping the polygon and LineString query payloads for each airspace check, and handling retries yourself. Through Jentic you install once, import the DFlight API from the API Directory, store any required customer credential once, and your agent calls it.
- **Permission scoping:** DFlight takes the query geometry in the request body rather than a resource id in the URL path, so limit the agent to the operations it needs, such as POST /us/v1/airspace/polygon-query or POST /us/v1/restrictions/route-query. Every operation here is a read-only preflight query, so the agent retrieves airspace and hazard data and performs no writes.
- **Credential handling:** Any DFlight customer credential is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'check drone airspace for a route', and Jentic returns the matching DFlight operation with its input schema so the agent submits a polygon or LineString without browsing the reference docs.

## Related APIs

- **OpenWeatherMap API** — Add general-purpose weather and forecast data alongside DFlight's UAV-focused weather endpoints
- **National Park Service API** — Combine US national park boundary and alert data with DFlight's restriction queries
- **AirNow API** — Layer US air quality data on top of DFlight's airspace and weather queries

## FAQ

### What authentication does the DFlight API use?

The published OpenAPI spec for DFlight does not declare a security scheme on the documented endpoints. In practice, DFlight is offered to commercial UAV operators by ljaero.com and access is provisioned per customer; check with the vendor for the credential type your account uses. When called via Jentic, any credential is held in your Jentic One instance and never enters the agent's context.

### Can I query a custom polygon instead of a point and radius?

Yes. Every data category exposes three query shapes: distance (point plus radius), route (GeoJSON LineString), and polygon (arbitrary GeoJSON Polygon). For an irregular operating area, send your polygon to the corresponding /us/v1/{category}/polygon-query endpoint.

### What are the rate limits for the DFlight API?

Rate limits are not published in the OpenAPI spec. ljaero applies per-customer throughput limits at the contract level for commercial UAV operators; contact the vendor for your tier. Queries are POST-based to allow large GeoJSON payloads, so plan around payload size as well as request count.

### How do I get a route hazard briefing for a planned drone flight through Jentic?

Search Jentic for 'check drone airspace and restrictions for a route'. Jentic returns the matching DFlight route-query operations for airspace, restrictions, weather, obstacles, and aerodromes. Load each schema, post your GeoJSON LineString, and consolidate the responses into a single briefing. Get started with Jentic One, the self-hosted execution layer.

### Does DFlight cover airspace outside the United States?

All endpoints documented in this spec are namespaced under /us/v1, indicating United States coverage only. International coverage is not exposed via this version of the API.

### Can DFlight tell me about aerodromes near my flight area?

Yes. The aerodromes resource has distance, route, and polygon query variants. Use /us/v1/aerodromes/distance-query for a point-and-radius lookup or /us/v1/aerodromes/polygon-query for an arbitrary operating area. The response identifies aerodromes that intersect the supplied geometry.

### Can I limit what my agent is allowed to do with the DFlight API?

Yes. Because Jentic One is self-hosted, you decide which DFlight operations your agent may call and which credential it may use. Every DFlight operation is a read-only preflight query that takes the flight geometry in the request body rather than a resource id in the path, so you can restrict the agent to just the operations it needs, such as POST /us/v1/airspace/polygon-query or POST /us/v1/restrictions/route-query, and it can retrieve airspace and hazard data while performing no writes. Any customer credential stays in your own instance and is injected only at execution time.