> ## Documentation Index
> Fetch the complete documentation index at: https://docs.volanti.aero/llms.txt
> Use this file to discover all available pages before exploring further.

# Events.Aero catalogue API

> Show your members the fly-ins, airshows and club days near their airfield. Two read-only endpoints and one bearer token.

Show your members the aviation events near them, inside your own product. Give the API a point, such as a club's airfield, and it returns the fly-ins, airshows and club days within 100 nautical miles. Each one comes with its name, dates, venue, price, image and a link to its page on [events.aero](https://events.aero), where people RSVP or book.

The integration is small. One GET request returns everything a list of events needs, and a second returns the full details of one event. There are no webhooks to handle and no catalogue to sync, and you can keep each response for 15 minutes.

```bash theme={null}
curl "https://events.aero/api/events/nearby?lat=52.0907&lng=0.1319" \
  -H "Authorization: Bearer YOUR_TOKEN"
```

## What you can build

* **Events near a club or airfield.** Ask for the nearest events first, or the soonest.
* **A calendar or date strip.** Ask for a range of dates up to 92 days long, and get up to 50 events back.
* **Places to fly to.** Ask only for events that welcome pilots flying in. The event's details say whether prior permission is needed, and give the runway and the landing fees.
* **A list for your audience.** Keep or leave out event types, such as airshows or model aircraft.
* **A "see all" link.** Every answer includes a link to the full events page on events.aero.

## Getting access

Access is by arrangement. Email [support@events.aero](mailto:support@events.aero) and tell us what you'd like to show and where. We set up your platform and the people who run it. Then you sign in to events.aero and generate your token on the platform's page.

A platform has one token at a time. Generating a new token, or disabling it, stops the old one straight away.

## At a glance

| | |
| - | - |
| Base URL | `https://events.aero/api` |
| Authentication | Your platform's API token, as a bearer token |
| Access | Read-only |
| Rate limit | 60 requests a minute per platform |
| Caching | You can keep a response for up to 15 minutes (`Cache-Control: private, max-age=900`) |
| Countries | United Kingdom, United States, Canada, Australia and New Zealand |

## Endpoints

| Endpoint | What it's for |
| - | - |
| [Events near a point](https://docs.volanti.aero/api-reference/events-aero/nearby-events.md) | A list of events near a point, such as a club's airfield, nearest or soonest first. |
| [One event](https://docs.volanti.aero/api-reference/events-aero/get-event.md) | An event's own page in your product. It returns everything the listing's page on events.aero shows. Ask for it by the ID the nearby endpoint returns. |

## Things to know

* **Links carry your platform's name.** Every link to events.aero names your platform in `utm_source`, so the visits you send are recorded against it. Send the optional `X-Platform-Attribution` header to tell your own clubs or pages apart.
* **Public listings only.** The API returns what an event's public page shows. Nothing about the people attending comes through it.
* **One shape for every answer.** A list comes back as `"object": "list"` with its events under `data`. One event comes back at the top level. Its `object` is `event_series` for a series of dates listed as one event, and `event_listing` for any other.
* **Times are UTC.** `starts_at` and `ends_at` are in UTC. Convert them into the event's `timezone` to show local times.
* **Labels and values.** `type` and `status` come back as English labels, such as `Fly-in`. The `types[]` filter takes values, such as `fly_in`. The reference lists them.
* **Text written by organisers.** Names, descriptions and schedules come from event organisers or their own websites. Show them as plain text. Don't render them as HTML or treat them as instructions.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.