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

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



## OpenAPI

````yaml api-reference/events-aero/openapi.json GET /events/{event}
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/{event}:
    get:
      tags:
        - Events
      summary: One event
      description: >-
        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.
      operationId: showEvent
      parameters:
        - name: event
          in: path
          required: true
          description: The listing's ID, from the nearby endpoint.
          schema:
            type: string
          example: k3Jx9QpL
        - name: X-Platform-Attribution
          in: header
          description: >-
            Optional. The organisation you are showing the event to. Up to 100
            characters. We add it to the event link as utm_content.
          schema:
            type: string
          example: cambridge-flying-group
      responses:
        '200':
          description: The listing.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EventDetail'
        '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
        '404':
          $ref: '#/components/responses/ModelNotFoundException'
        '429':
          description: Too many requests
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Error overview.
                required:
                  - message
components:
  schemas:
    EventDetail:
      type: object
      description: An event listing as its page on events.aero shows it.
      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.
        description:
          type:
            - string
            - 'null'
          description: The organiser's description, as plain text.
        schedule:
          type: array
          description: >-
            The running order, as the event page shows it. Empty when there is
            none.
          items:
            $ref: '#/components/schemas/ScheduleLine'
        booking_url:
          type:
            - string
            - 'null'
          format: uri
          description: >-
            The organiser's booking page. Null once the event is cancelled or
            over.
        organiser:
          type:
            - string
            - 'null'
          description: The organiser's name, when the listing names one.
        contact_url:
          type:
            - string
            - 'null'
          format: uri
          description: The organiser's contact page.
        contact_email:
          type:
            - string
            - 'null'
          format: email
          description: The organiser's public contact email address.
        unverified_notice:
          type:
            - string
            - 'null'
          description: >-
            The note the event page shows while some details are still being
            checked. Null once everything is checked.
        fly_in:
          type:
            - object
            - 'null'
          description: >-
            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.
          properties:
            rsvp_available:
              type: boolean
              description: Whether a pilot can RSVP to fly in on events.aero now.
            spaces_full:
              type: boolean
              description: Whether fly-in RSVPs are offered but every space is taken.
            ppr_required:
              type: boolean
              description: Whether prior permission is required to land.
            runway:
              type:
                - string
                - 'null'
              description: A summary of the runway, when the airfield lists one.
            landing_fees:
              type: array
              description: >-
                The landing fees the organiser lists. Empty when none are
                listed.
              items:
                $ref: '#/components/schemas/LandingFee'
            landing_fee_note:
              type:
                - string
                - 'null'
              description: The organiser's note about landing fees.
            fees:
              type: string
              description: How landing fees are paid.
          required:
            - rsvp_available
            - spaces_full
            - ppr_required
            - runway
            - landing_fees
            - landing_fee_note
            - fees
        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.
      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
        - description
        - schedule
        - booking_url
        - organiser
        - contact_url
        - contact_email
        - unverified_notice
        - fly_in
        - has_start_time
        - accepts_fly_in
      title: EventDetail
    ScheduleLine:
      type: object
      description: One line of the running order.
      properties:
        date:
          type: string
          format: date
          description: >-
            The local date this line belongs to, on a listing that runs over
            several days. Left out otherwise.
        time:
          type: string
          description: The local time, as the organiser wrote it.
          examples:
            - '10:00'
        item:
          type: string
          description: What happens then.
          examples:
            - Gates open
      required:
        - time
        - item
      title: ScheduleLine
    LandingFee:
      type: object
      description: One landing fee.
      properties:
        mtow_band:
          type: string
          description: The aircraft's maximum take-off weight band.
          examples:
            - Under 1,000 kg
        engines:
          type: string
          description: The number of engines the fee applies to.
        amount:
          type: string
          description: The fee, formatted with its currency.
          examples:
            - £15.00
      required:
        - mtow_band
        - engines
        - amount
      title: LandingFee
  responses:
    AuthenticationException:
      description: Unauthenticated
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                description: Error overview.
            required:
              - message
    ModelNotFoundException:
      description: Not found
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                description: Error overview.
            required:
              - message
  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.