Skip to main content
GET
Events near a point

Authorizations

Authorization
string
header
required

Your platform's API token, sent as a bearer token.

Headers

X-Platform-Attribution
string

Optional. The organisation you are showing events to, such as a club's name or reference. Up to 100 characters. We add it to the event links as utm_content, so you can tell each organisation's visits apart.

Query Parameters

lat
number
required

Latitude of the point, in decimal degrees.

Required range: -90 <= x <= 90
lng
number
required

Longitude of the point, in decimal degrees.

Required range: -180 <= x <= 180
limit
integer | null
default:6

How many events to return. The most is 12, or 50 when you give a date range. Defaults to 6.

Required range: 1 <= x <= 12
from
string<date> | null

Only events on or after this local date (YYYY-MM-DD, in each event's own time zone). Together with to, the range can cover up to 92 days.

to
string<date> | null

Only events on or before this local date (YYYY-MM-DD). It can't be earlier than from.

fly_in
boolean | null

Only events that welcome pilots flying in.

types[]
enum<string>[] | null

Only events of these types. Repeat the parameter to ask for several, as in types[]=fly_in&types[]=airshow.

Maximum array length: 14

The value to filter by for each kind of event. Responses name the type in words, such as "Fly-in".

Available options:
airshow,
fly_in,
static_display,
workshop,
seminar,
online_event,
club_meet,
conference,
expo,
competition,
charity_event,
military,
spotting,
model_aircraft
exclude_types[]
enum<string>[] | null

Leave out events of these types. An event with no type stays in. If you also send types, these are taken away from that list.

Maximum array length: 14

The value to filter by for each kind of event. Responses name the type in words, such as "Fly-in".

Available options:
airshow,
fly_in,
static_display,
workshop,
seminar,
online_event,
club_meet,
conference,
expo,
competition,
charity_event,
military,
spotting,
model_aircraft
sort
enum<string> | null

nearest (the default) puts the closest event first. soonest puts the earliest start first, going by a series' next date, and the closer event first when two start together. How to order nearby events. "nearest" puts the closest first. "soonest" puts the earliest start first, and the closer one first when two start together.

Available options:
nearest,
soonest

Response

The events near the point.

The listings near the point, in the order you asked for. Empty when there are none.

object
string
required

What this object is. Always "list".

Allowed value: "list"
data
NearbyEvent · object[]
required

The listings near the point, in the order you asked for. Empty when there are none.

see_all_url
string<uri> | null
required

The events page on events.aero for the nearest event's country, with your tracking parameters. Use it for a "see all" link. Null when there are no events.