curl --request GET \
--url https://events.aero/api/events/nearby \
--header 'Authorization: Bearer <token>'import requests
url = "https://events.aero/api/events/nearby"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://events.aero/api/events/nearby', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://events.aero/api/events/nearby",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://events.aero/api/events/nearby"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://events.aero/api/events/nearby")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://events.aero/api/events/nearby")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"object": "list",
"data": [
{
"id": "k3Jx9QpL",
"object": "event_listing",
"slug": "popham-microlight-fly-in",
"url": "<string>",
"name": "Popham microlight fly-in",
"type": "Airshow",
"status": "Published",
"starts_at": "2027-07-18T12:00:00Z",
"ends_at": "2023-11-07T05:31:56Z",
"timezone": "Europe/London",
"when": "<string>",
"provisional": true,
"online": true,
"venue": {
"name": "Popham Airfield",
"town": "Basingstoke",
"kind": "Airfield or airport",
"icao_code": "EGHP",
"radio_frequency": "129.805"
},
"country": {
"code": "GB",
"name": "United Kingdom"
},
"is_free": true,
"price_from": "£15.00",
"rsvp_available": true,
"image_url": "<string>",
"has_start_time": true,
"accepts_fly_in": true,
"distance_nm": 12.4
}
],
"see_all_url": "<string>"
}{
"message": "<string>"
}{
"message": "<string>"
}{
"message": "<string>",
"errors": {}
}{
"message": "<string>"
}Events near a point
The list of events near a club or airfield. Give it a point and it returns the listings within 100 nautical miles that have not finished yet, so an event under way today still shows. They come nearest first, unless you ask for the soonest first. Only published listings are included, in the countries Events.Aero has launched in.
You can narrow the results to a range of local dates (enough for a calendar or date strip), to listings that welcome pilots flying in, or by type. The answer also carries a link to the full events page, for a “see all” link.
curl --request GET \
--url https://events.aero/api/events/nearby \
--header 'Authorization: Bearer <token>'import requests
url = "https://events.aero/api/events/nearby"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://events.aero/api/events/nearby', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://events.aero/api/events/nearby",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://events.aero/api/events/nearby"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://events.aero/api/events/nearby")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://events.aero/api/events/nearby")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"object": "list",
"data": [
{
"id": "k3Jx9QpL",
"object": "event_listing",
"slug": "popham-microlight-fly-in",
"url": "<string>",
"name": "Popham microlight fly-in",
"type": "Airshow",
"status": "Published",
"starts_at": "2027-07-18T12:00:00Z",
"ends_at": "2023-11-07T05:31:56Z",
"timezone": "Europe/London",
"when": "<string>",
"provisional": true,
"online": true,
"venue": {
"name": "Popham Airfield",
"town": "Basingstoke",
"kind": "Airfield or airport",
"icao_code": "EGHP",
"radio_frequency": "129.805"
},
"country": {
"code": "GB",
"name": "United Kingdom"
},
"is_free": true,
"price_from": "£15.00",
"rsvp_available": true,
"image_url": "<string>",
"has_start_time": true,
"accepts_fly_in": true,
"distance_nm": 12.4
}
],
"see_all_url": "<string>"
}{
"message": "<string>"
}{
"message": "<string>"
}{
"message": "<string>",
"errors": {}
}{
"message": "<string>"
}Headers
Query Parameters
Only events of these types. Repeat the parameter to ask for several, as in types[]=fly_in&types[]=airshow.
14The value to filter by for each kind of event. Responses name the type in words, such as "Fly-in".
airshow, fly_in, static_display, workshop, seminar, online_event, club_meet, conference, expo, competition, charity_event, military, spotting, model_aircraft 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.
14The value to filter by for each kind of event. Responses name the type in words, such as "Fly-in".
airshow, fly_in, static_display, workshop, seminar, online_event, club_meet, conference, expo, competition, charity_event, military, spotting, model_aircraft 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.
nearest, soonest Response
The events near the point.
The listings near the point, in the order you asked for. Empty when there are none.

