Skip to main content
GET
One event

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 the event to. Up to 100 characters. We add it to the event link as utm_content.

Path Parameters

event
string
required

The listing's ID, from the nearby endpoint.

Response

The listing.

An event listing as its page on events.aero shows it.

id
string
required

The listing's ID. Pass it to the single event endpoint.

Example:

"k3Jx9QpL"

object
enum<string>
required

What this object is. "event_series" is a series of dates listed as one event, shown on its next date. Any other event is "event_listing".

Available options:
event_listing,
event_series
slug
string
required

The last part of the listing's address on events.aero.

Example:

"popham-microlight-fly-in"

url
string<uri>
required

The listing's page on events.aero, with your platform's tracking parameters, and the organisation from the X-Platform-Attribution header when you send one. Link people here.

name
string
required

The event's name.

Example:

"Popham microlight fly-in"

type
enum<string> | null
required

The kind of event, as its card names it.

Available options:
Airshow,
Fly-in,
Static display,
Workshop,
Seminar,
Online event,
Club meet,
Conference,
Expo,
Competition,
Charity event,
Military,
Spotting,
Model aircraft,
null
status
enum<string>
required

The listing's status. Nearby events are always "Published". A single event can also be "Completed" or "Cancelled".

Available options:
Published,
Completed,
Cancelled
starts_at
string<date-time>
required

When the event starts, in UTC (ISO 8601). For a series, this is its next date. When has_start_time is false, use only the local date.

Example:

"2027-07-18T12:00:00Z"

ends_at
string<date-time> | null
required

When the event ends, in UTC (ISO 8601), when it is known.

timezone
string
required

The event's own time zone (IANA). Convert starts_at and ends_at into it to show local times.

Example:

"Europe/London"

when
string
required

The date line from the event's card, in English and in the event's local time. It gives the date, and the start time when there is one. A series also says how many more dates follow.

provisional
boolean
required

Whether the listing is provisional. That means we expect the event to take place, but its organiser hasn't published how to attend yet.

online
boolean
required

Whether the event takes place online.

venue
object | null
required

Where the event takes place. When we have no venue on record, name holds the place as the organiser wrote it. Null when the listing names no place.

country
object
required

The country the event is in.

is_free
boolean
required

Whether entry is free.

price_from
string | null
required

The lowest price, formatted with its currency, or null when free or unknown.

Example:

"£15.00"

rsvp_available
boolean
required

Whether people can RSVP on events.aero now.

image_url
string<uri> | null
required

The listing's header image, when it has one.

description
string | null
required

The organiser's description, as plain text.

schedule
ScheduleLine · object[]
required

The running order, as the event page shows it. Empty when there is none.

booking_url
string<uri> | null
required

The organiser's booking page. Null once the event is cancelled or over.

organiser
string | null
required

The organiser's name, when the listing names one.

contact_url
string<uri> | null
required

The organiser's contact page.

contact_email
string<email> | null
required

The organiser's public contact email address.

unverified_notice
string | null
required

The note the event page shows while some details are still being checked. Null once everything is checked.

fly_in
object | null
required

Details for pilots flying in. Null when the event doesn't welcome them, or is over. Contact details for prior permission are on the event page only.

has_start_time
boolean
required

Whether starts_at has a real start time. False for a listing with dates only, or one that runs over several days.

accepts_fly_in
boolean
required

Whether pilots are welcome to fly in.