One event
curl --request GET \
--url https://events.aero/api/events/{event} \
--header 'Authorization: Bearer <token>'import requests
url = "https://events.aero/api/events/{event}"
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/{event}', 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/{event}",
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/{event}"
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/{event}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://events.aero/api/events/{event}")
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{
"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>",
"description": "<string>",
"schedule": [
{
"time": "10:00",
"item": "Gates open",
"date": "2023-12-25"
}
],
"booking_url": "<string>",
"organiser": "<string>",
"contact_url": "<string>",
"contact_email": "[email protected]",
"unverified_notice": "<string>",
"fly_in": {
"rsvp_available": true,
"spaces_full": true,
"ppr_required": true,
"runway": "<string>",
"landing_fees": [
{
"mtow_band": "Under 1,000 kg",
"engines": "<string>",
"amount": "£15.00"
}
],
"landing_fee_note": "<string>",
"fees": "<string>"
},
"has_start_time": true,
"accepts_fly_in": true
}{
"message": "<string>"
}{
"message": "<string>"
}{
"message": "<string>"
}{
"message": "<string>"
}Events.Aero catalogue API
One event
Everything you need to show one event in your own product. It returns what the listing’s page on events.aero shows. That is the fields the nearby endpoint gives, plus the description, running order, booking and contact links, organiser and details for pilots flying in (prior permission, runway and landing fees).
You can read a listing for as long as its page on events.aero is public. That covers published and completed listings, and ones cancelled after they went live. Any other ID returns 404, including the ID of one day of a listing that runs over several days.
GET
/
events
/
{event}
One event
curl --request GET \
--url https://events.aero/api/events/{event} \
--header 'Authorization: Bearer <token>'import requests
url = "https://events.aero/api/events/{event}"
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/{event}', 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/{event}",
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/{event}"
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/{event}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://events.aero/api/events/{event}")
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{
"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>",
"description": "<string>",
"schedule": [
{
"time": "10:00",
"item": "Gates open",
"date": "2023-12-25"
}
],
"booking_url": "<string>",
"organiser": "<string>",
"contact_url": "<string>",
"contact_email": "[email protected]",
"unverified_notice": "<string>",
"fly_in": {
"rsvp_available": true,
"spaces_full": true,
"ppr_required": true,
"runway": "<string>",
"landing_fees": [
{
"mtow_band": "Under 1,000 kg",
"engines": "<string>",
"amount": "£15.00"
}
],
"landing_fee_note": "<string>",
"fees": "<string>"
},
"has_start_time": true,
"accepts_fly_in": true
}{
"message": "<string>"
}{
"message": "<string>"
}{
"message": "<string>"
}{
"message": "<string>"
}Headers
Response
The listing.
An event listing as its page on events.aero shows it.

