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
propertyStatus#
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.
Modified at 2025-04-01 22:38:16