Events.Aero

Search upcoming public aviation events on Events.Aero (airshows, fly-ins, workshops and more). Filter by free text, event type, country, date range, distance from a point, free entry or online events. Results are ordered by start date, or by distance when latitude and longitude are given, one page at a time. Every result includes the public event page URL: send people there to book or RSVP.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Free text matched against the event name, venue name, town and location (up to 100 characters)",
      "type": "string"
    },
    "type": {
      "description": "Event type, from list-event-types",
      "enum": [
        "airshow",
        "fly_in",
        "static_display",
        "workshop",
        "seminar",
        "online_event",
        "club_meet",
        "conference",
        "expo",
        "competition",
        "charity_event"
      ],
      "type": "string"
    },
    "country": {
      "description": "Two-letter country code, e.g. GB: list-countries lists the live countries; a soft-launched country is answered only when named (without one, only live countries are searched)",
      "type": "string"
    },
    "from": {
      "description": "Earliest start date, YYYY-MM-DD: a calendar date matched against each event's own local start date (in the event's timezone)",
      "type": "string"
    },
    "to": {
      "description": "Latest start date, YYYY-MM-DD, inclusive: a calendar date matched against each event's own local start date",
      "type": "string"
    },
    "latitude": {
      "description": "Search near this point (with longitude); results are ordered by distance",
      "type": "number"
    },
    "longitude": {
      "description": "Search near this point (with latitude)",
      "type": "number"
    },
    "radius_nm": {
      "description": "Radius around the point in nautical miles (default 50, at most 500)",
      "type": "integer"
    },
    "free": {
      "description": "Only free events",
      "type": "boolean"
    },
    "online": {
      "description": "Only online events",
      "type": "boolean"
    },
    "page": {
      "description": "Page of results, from 1",
      "type": "integer"
    },
    "per_page": {
      "description": "Results per page (default 20, at most 50)",
      "type": "integer"
    }
  }
}

Get one public event by its sqid or slug (from search-events or featured-events): dates, venue, price, how to book or RSVP, organiser contact details shown on the event page, flying in (PPR, runway, landing fees and whether pilots can RSVP to fly in), the day's schedule and the description. Always share the event page URL.

{
  "type": "object",
  "properties": {
    "event": {
      "description": "The event sqid or slug",
      "type": "string"
    }
  },
  "required": [
    "event"
  ]
}

The events Events.Aero is featuring right now, the same selection as the lead row of the home page, optionally for one country. Each includes its public event page URL.

{
  "type": "object",
  "properties": {
    "country": {
      "description": "Two-letter country code, e.g. GB: list-countries lists the live countries; a soft-launched country is answered only when named",
      "type": "string"
    }
  }
}

The kinds of aviation event on Events.Aero (airshow, fly-in, workshop and so on), with the value to pass to search-events and the public page that lists each type in a country.

{
  "type": "object",
  "properties": {
    "country": {
      "description": "Two-letter country code for the browse links (default GB): list-countries lists the live countries; a soft-launched country can be named too",
      "type": "string"
    }
  }
}

The countries Events.Aero lists events in, with the code to pass to other tools and each country's public home and events pages.

{
  "type": "object",
  "properties": {}
}