AirHub API
  1. B4UFLY
AirHub API
  • Introduction
  • Authorization
    • Overview
    • Get Oauth Token
      POST
  • Advisories
    • Advisory
      POST
    • Get Advisories BBox
      GET
    • Get Advisories GeoJSON
      POST
  • Briefing
    • Overview
    • B4UFLY
      • What Is B4UFLY
      • The API Basics
      • Location vs Area
      • v1
        • B4UFLY Briefing by Area v1
        • B4UFLY Briefing by Location v1
      • v2
        • What's New in v2
        • B4UFLY Briefing by Area v2
        • B4UFLY Briefing by Location v2
  • LAANC SDSP
    • Overview
    • ASL Operations
      • List Operations
      • Create Operation
      • Get Operation
      • Delete Operation
      • Update Operation
    • LAANC Operations
      • Get Operation
      • Delete Operation
      • Create Operation
      • Update Operation
    • LAANC Authorizations
      • Rescinded and Invalid Operations
      • Submit Authorization
      • Get Authorization
      • Cancel Authorization
      • Cancel Invalid Authorization
      • Close Authorization
      • Acknowledge Rescinded Authorization
    • Operation v2
      POST
    • Create Ephemeral Operations
      POST
  • Risk
    • Get Hazard
      POST
    • Get Hazard Ground Type
      POST
    • Get Hazard Ground Risk
      POST
  • Aviation
    • Aviation
      POST
  • Surface
    • Overview
    • Suitability
    • Classification Surface
    • Surface v2 GeoJSON
    • Surface v2 Hexbin
  • Route
    • Route v2
  • Check
    • Check Airspace
    • Get Status
  • Elevation - NEW
    • Get List
  • Map Vector Tiles - NEW
    • Overview
    • Styled Tiles
    • Vector Tile
  • Flight
    • Get Flight Last Position QUERY
    • Get Flight Last Position INFO
  • Data Notification Subscribers
    • Get List
  1. B4UFLY

The API Basics

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.
Modified at 2025-04-01 22:38:16
Previous
What Is B4UFLY
Next
Location vs Area
Built with