Advisory - AirHub API

Request

Header Params

Content-Type

enum<string>

required

Allowed value:

application/json;charset=UTF-8

Example:

application/json;charset=UTF-8

Authorization

string

required

Authorization bearer accessToken generated in Authorization step

Default:

Example:

Body Params application/json

geometry

object

required

GeoJSON formatted geometry. Available geometries may be a point, line, or polygon. The resulting bounding box of the geometry can't have a side length greater than 30 nautical miles.

coordinates

array [array]

required

type

string

required

category

string

required

This is the specified rule category under which you'll be flying.

Category	Description
faa_107	FAA Commercial UAS Flight
faa_44809	FAA Recreational UAS Flight

source

string

optional

Represents the source of the advsiory or the authority that created the advisory. Additional sources will be made available in the future.

Source	Description
faa	Federal (FAA) advisories
community	State & Local community advisories
all	All available advisories

startTime

string

optional

Filters advisories that are active at the same time as, or after startTime. Send as YYYY-MM-DDThh:mmZ.

endTime

string

optional

Filters advisories that are active at the same time as, or after endTime. Send as YYYY-MM-DDThh:mmZ.

maxAltitude

integer

optional

The maximimum altitude anticipated for the operation. This helps to determine FAA restrictions.

Example

{
    "category": "faa_com_part_107",
    "geometry": {
        "coordinates": [
            [
                [
                    -83.2592354683282,
                    42.2395810171841
                ],
                [
                    -83.3862648872736,
                    42.2395810171841
                ],
                [
                    -83.3862648872736,
                    42.1378288396814
                ],
                [
                    -83.2592354683282,
                    42.1378288396814
                ],
                [
                    -83.2592354683282,
                    42.2395810171841
                ]
            ]
        ],
        "type": "Polygon"
    }
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://airhub-api-sandbox.airspacelink.com/v2/advisory' \
--header 'Authorization: ' \
--header 'Content-Type: application/json;charset=UTF-8' \
--data-raw '{
    "category": "faa_com_part_107",
    "geometry": {
        "coordinates": [
            [
                [
                    -83.2592354683282,
                    42.2395810171841
                ],
                [
                    -83.3862648872736,
                    42.2395810171841
                ],
                [
                    -83.3862648872736,
                    42.1378288396814
                ],
                [
                    -83.2592354683282,
                    42.1378288396814
                ],
                [
                    -83.2592354683282,
                    42.2395810171841
                ]
            ]
        ],
        "type": "Polygon"
    }
}'

Responses

🟢200Success

application/json

Body

data

array [object {3}]

required

geometry

object

optional

properties

object

optional

type

string

optional

message

string

required

statusCode

integer

required

Example

{
    "data": [
        {
            "geometry": {
                "coordinates": [
                    []
                ],
                "type": "Polygon"
            },
            "properties": {
                "advisorySource": "faa",
                "advisoryType": "uasfm_ceiling",
                "contactEmail": "john@gov.gov",
                "contactName": "John Doe",
                "contactPhone": "+12345678910",
                "contactUrl": "http://myadvisory.com/1234",
                "effectiveDays": [
                    "Mon",
                    "Tue",
                    "Fri"
                ],
                "endDate": "2020-01-01T00:00:00.0000000+00:00",
                "endTime": "2020-12-16T20:00:00.0000000+00:00",
                "message": "The max altitude exceeds ...",
                "severity": "warning",
                "startDate": "2020-01-01T00:00:00.0000000+00:00",
                "startTime": "2020-12-16T10:10:00.0000000+00:00",
                "timezone": "America/New_York",
                "title": "UASFM Grid"
            },
            "type": "Feature"
        }
    ],
    "message": "success",
    "statusCode": 200
}

🟠400400

🔴500500