> ## 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 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.



## OpenAPI

````yaml api-reference/events-aero/openapi.json GET /events/nearby
openapi: 3.1.2
info:
  title: Events.Aero catalogue API
  version: 1.0.0
  description: >-
    Show your members the aviation events near them. Ask for the fly-ins,
    airshows and club days near a point, such as a club's airfield, then for the
    full details of the one somebody opens.


    Every listing links to its page on events.aero, where people RSVP or book.
    The link names your platform, so the visits you send are recorded against
    it.


    **Access.** Send your platform's API token with each request, as a bearer
    token (`Authorization: Bearer <token>`). Access is by arrangement, so the
    Events.Aero team sets up each platform and the people who run it. Once yours
    is set up, sign in to events.aero and generate the token on the platform's
    page. A platform has one token at a time, so generating a new one (or
    disabling it) stops the old one straight away.


    **Limits.** You can make 60 requests a minute per platform, and keep a
    response for up to 15 minutes (`Cache-Control: private, max-age=900`).


    **Times.** `starts_at` and `ends_at` are in UTC. Convert them into the
    event's `timezone` to show local times.
servers:
  - url: https://events.aero/api
    description: Events.Aero
security:
  - platformToken: []
tags:
  - name: Events
paths:
  /events/nearby:
    get:
      tags:
        - Events
      summary: Events near a point
      description: >-
        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.
      operationId: nearbyEvents
      parameters:
        - name: lat
          in: query
          required: true
          description: Latitude of the point, in decimal degrees.
          schema:
            type: number
            minimum: -90
            maximum: 90
          example: 51.1956
        - name: lng
          in: query
          required: true
          description: Longitude of the point, in decimal degrees.
          schema:
            type: number
            minimum: -180
            maximum: 180
          example: -1.2353
        - name: limit
          in: query
          description: >-
            How many events to return. The most is 12, or 50 when you give a
            date range. Defaults to 6.
          schema:
            type:
              - integer
              - 'null'
            default: 6
            minimum: 1
            maximum: 12
        - name: from
          in: query
          description: >-
            Only events on or after this local date (YYYY-MM-DD, in each event's
            own time zone). Together with to, the range can cover up to 92 days.
          schema:
            type:
              - string
              - 'null'
            format: date
          example: '2027-07-01'
        - name: to
          in: query
          description: >-
            Only events on or before this local date (YYYY-MM-DD). It can't be
            earlier than from.
          schema:
            type:
              - string
              - 'null'
            format: date
          example: '2027-07-31'
        - name: fly_in
          in: query
          description: Only events that welcome pilots flying in.
          schema:
            type:
              - boolean
              - 'null'
        - name: types[]
          in: query
          description: >-
            Only events of these types. Repeat the parameter to ask for several,
            as in types[]=fly_in&types[]=airshow.
          schema:
            type:
              - array
              - 'null'
            items:
              $ref: '#/components/schemas/EventType'
            maxItems: 14
        - name: exclude_types[]
          in: query
          description: >-
            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.
          schema:
            type:
              - array
              - 'null'
            items:
              $ref: '#/components/schemas/EventType'
            maxItems: 14
        - name: sort
          in: query
          description: >-
            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.
          schema:
            anyOf:
              - $ref: '#/components/schemas/NearbyEventsSort'
              - type: 'null'
        - name: X-Platform-Attribution
          in: header
          description: >-
            Optional. The organisation you are showing events to, such as a
            club's name or reference. Up to 100 characters. We add it to the
            event links as utm_content, so you can tell each organisation's
            visits apart.
          schema:
            type: string
          example: cambridge-flying-group
      responses:
        '200':
          description: The events near the point.
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/NearbyEvents'
                  - type: object
                    properties:
                      see_all_url:
                        type:
                          - string
                          - 'null'
                        format: uri
                        description: >-
                          The events page on events.aero for the nearest event's
                          country, with your tracking parameters. Use it for a
                          "see all" link. Null when there are no events.
                    required:
                      - see_all_url
        '401':
          $ref: '#/components/responses/AuthenticationException'
        '403':
          description: The token does not allow reading the catalogue.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                required:
                  - message
        '422':
          $ref: '#/components/responses/ValidationException'
        '429':
          description: Too many requests
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Error overview.
                required:
                  - message
components:
  schemas:
    EventType:
      type: string
      description: >-
        The value to filter by for each kind of event. Responses name the type
        in words, such as "Fly-in".
      enum:
        - airshow
        - fly_in
        - static_display
        - workshop
        - seminar
        - online_event
        - club_meet
        - conference
        - expo
        - competition
        - charity_event
        - military
        - spotting
        - model_aircraft
      title: EventType
    NearbyEventsSort:
      type: string
      description: >-
        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.
      enum:
        - nearest
        - soonest
      title: NearbyEventsSort
    NearbyEvents:
      type: object
      description: >-
        The listings near the point, in the order you asked for. Empty when
        there are none.
      properties:
        object:
          type: string
          description: What this object is. Always "list".
          const: list
        data:
          type: array
          description: >-
            The listings near the point, in the order you asked for. Empty when
            there are none.
          items:
            $ref: '#/components/schemas/NearbyEvent'
      required:
        - object
        - data
      title: NearbyEvents
    NearbyEvent:
      type: object
      description: An event listing near the point you asked about.
      properties:
        id:
          type: string
          description: The listing's ID. Pass it to the single event endpoint.
          examples:
            - k3Jx9QpL
        object:
          type: string
          description: >-
            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".
          enum:
            - event_listing
            - event_series
        slug:
          type: string
          description: The last part of the listing's address on events.aero.
          examples:
            - popham-microlight-fly-in
        url:
          type: string
          format: uri
          description: >-
            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:
          type: string
          description: The event's name.
          examples:
            - Popham microlight fly-in
        type:
          type:
            - string
            - 'null'
          description: The kind of event, as its card names it.
          enum:
            - Airshow
            - Fly-in
            - Static display
            - Workshop
            - Seminar
            - Online event
            - Club meet
            - Conference
            - Expo
            - Competition
            - Charity event
            - Military
            - Spotting
            - Model aircraft
            - null
        status:
          type: string
          description: >-
            The listing's status. Nearby events are always "Published". A single
            event can also be "Completed" or "Cancelled".
          enum:
            - Published
            - Completed
            - Cancelled
        starts_at:
          type: string
          format: date-time
          description: >-
            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.
          examples:
            - '2027-07-18T12:00:00Z'
        ends_at:
          type:
            - string
            - 'null'
          format: date-time
          description: When the event ends, in UTC (ISO 8601), when it is known.
        timezone:
          type: string
          description: >-
            The event's own time zone (IANA). Convert starts_at and ends_at into
            it to show local times.
          examples:
            - Europe/London
        when:
          type: string
          description: >-
            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:
          type: boolean
          description: >-
            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:
          type: boolean
          description: Whether the event takes place online.
        venue:
          type:
            - object
            - 'null'
          description: >-
            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.
          properties:
            name:
              type: string
              description: The venue's name.
              examples:
                - Popham Airfield
            town:
              type:
                - string
                - 'null'
              description: The town the venue is in.
              examples:
                - Basingstoke
            kind:
              type:
                - string
                - 'null'
              description: The kind of venue.
              enum:
                - Airfield or airport
                - Aviation venue
                - Other venue
                - null
            icao_code:
              type:
                - string
                - 'null'
              description: The airfield's ICAO code, for an airfield that has one.
              examples:
                - EGHP
            radio_frequency:
              type:
                - string
                - 'null'
              description: The airfield's radio frequency, for an airfield that lists one.
              examples:
                - '129.805'
          required:
            - name
            - town
            - kind
            - icao_code
            - radio_frequency
        country:
          type: object
          description: The country the event is in.
          properties:
            code:
              type: string
              description: ISO 3166-1 alpha-2 code.
              examples:
                - GB
            name:
              type:
                - string
                - 'null'
              description: The country's name in English.
              examples:
                - United Kingdom
          required:
            - code
            - name
        is_free:
          type: boolean
          description: Whether entry is free.
        price_from:
          type:
            - string
            - 'null'
          description: >-
            The lowest price, formatted with its currency, or null when free or
            unknown.
          examples:
            - £15.00
        rsvp_available:
          type: boolean
          description: Whether people can RSVP on events.aero now.
        image_url:
          type:
            - string
            - 'null'
          format: uri
          description: The listing's header image, when it has one.
        has_start_time:
          type: boolean
          description: >-
            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:
          type: boolean
          description: Whether pilots are welcome to fly in.
        distance_nm:
          type: number
          description: >-
            How far the event is from the point asked about, in nautical miles,
            to one decimal place.
          examples:
            - 12.4
      required:
        - id
        - object
        - slug
        - url
        - name
        - type
        - status
        - starts_at
        - ends_at
        - timezone
        - when
        - provisional
        - online
        - venue
        - country
        - is_free
        - price_from
        - rsvp_available
        - image_url
        - has_start_time
        - accepts_fly_in
        - distance_nm
      title: NearbyEvent
  responses:
    AuthenticationException:
      description: Unauthenticated
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                description: Error overview.
            required:
              - message
    ValidationException:
      description: Validation error
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                description: Errors overview.
              errors:
                type: object
                description: A detailed description of each field that failed validation.
                additionalProperties:
                  type: array
                  items:
                    type: string
            required:
              - message
              - errors
  securitySchemes:
    platformToken:
      type: http
      description: Your platform's API token, sent as a bearer token.
      scheme: bearer

````

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