The API Basics

The API provides a B4UFLY briefing based on either a location defined by a latitude and longitude or an area defined by a boundary. The response includes a status, an authorizationType, and an array of notices. The notices returned are all the supporting evidence and awareness that contributes to the status and authorizationType. If you are simply trying to inform the user whether they can fly or not, you can simply reference the top-level status property

Status

The top level status property returned by the API conveys the safety of flight at the location or area requested. This considers the status of all the intersecting notices and automatically is the most severe.

Warning – you probably can NOT fly, due to a National Sercurity UAS Flight Restriction or a Temporary Flight Restriction, but you should direct users to AirHub Portal to get LAANC to determine if the intended flight time coincides with the active time of a Temporary Flight Restriction or part-time National Security UAS Flight Restriction.

Caution – you probably can fly, but users likely need authorization and other information provided to them, so you should direct users to AirHub Portal to get LAANC.

Clear to Fly – yes you can fly (according to the FAA), but pilots should check local restrictions to ensure compliance with local laws

Authorization Type

The autorizationType property returned by the API considers all the intersecting notices and indicates the appropriate authorization type.

Not Required - no authorization is needed to fly at this location or area and there are no flight restrictions.

Drone Zone - authorization is required, but users must use Drone Zone to obtain authorization, because LAANC is not available at this location or area

LAANC - authorization is required, and LAANC authorization is available at this location or area

Restricted - authorization may or may not be required, but flights are not allowed due to flight restricted airspace at this location or area

Notices

The array of notices that are returned are simply supporting evidence for the top level status and authorizationType values. Each notice contains information to provide to operators about the airspace at the location or area of flight. This includes details about the airspace to include a type (code), title, description, schedule (if applicable), source, and rule information.

The code property is effectively the type of airspace or notice

The status property on each individual notice is relevant only to the status of that notice and conveys the safety of flight for that notice.

The description property contains information to inform operators. If the description is empty, then the ruleDescription has useful information for operators.

The API Basics

The API Basics#

Status#

Authorization Type#

Notices#

The API Basics

Status

Authorization Type

Notices