GetYourGuide Tours API

openapi: 3.0.0
info:
  title: Partner Api Bookings Tours API
  description: This GetYourGuide Partner API provides access to GetYourGuide’s marketplace for tours and activities. It has a RESTful interface and uses the JSON media format. Access is secured via SSL and an API access token. Further documentation can be found in the public GitHub repository linked below. Do not forget to also check out the GitHub wiki for some more extensive guides.
  version: 1.0.0
  contact:
    name: Partner Tech
    url: https://partner.getyourguide.com/
  license:
    name: Apache License, Version 2.0
    url: https://github.com/getyourguide/partner-api-spec/blob/main/LICENSE
servers:
- url: https://api.getyourguide.com
  description: Production
- url: https://api.gygtest.net
  description: Testing
security:
- ApiKeyAuth: []
tags:
- name: Tours
paths:
  /{version}/tours:
    get:
      operationId: ToursQuery
      summary: Search for tours by different parameters such as a query or geographical coordinates.
      tags:
      - Tours
      parameters:
      - $ref: '#/components/parameters/version'
      - $ref: '#/components/parameters/cntLanguage'
      - $ref: '#/components/parameters/currency'
      - $ref: '#/components/parameters/preformatted'
      - $ref: '#/components/parameters/q'
      - $ref: '#/components/parameters/coordinates'
      - $ref: '#/components/parameters/dates'
      - $ref: '#/components/parameters/condLanguages'
      - $ref: '#/components/parameters/prices'
      - $ref: '#/components/parameters/categories'
      - $ref: '#/components/parameters/ratings'
      - $ref: '#/components/parameters/durations'
      - $ref: '#/components/parameters/flags'
      - $ref: '#/components/parameters/sortfield-2'
      - $ref: '#/components/parameters/sortdirection'
      - $ref: '#/components/parameters/limit'
      - $ref: '#/components/parameters/offset'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  _metadata:
                    $ref: '#/components/schemas/MetaData'
                  data:
                    type: object
                    properties:
                      tours:
                        type: array
                        items:
                          $ref: '#/components/schemas/Tour'
        '400':
          description: Missing Parameters
        '500':
          description: Server error
  /{version}/tours/{tour_id}:
    get:
      operationId: ToursByIdQuery
      summary: Search for tours by id
      tags:
      - Tours
      parameters:
      - $ref: '#/components/parameters/version'
      - $ref: '#/components/parameters/tourId'
      - $ref: '#/components/parameters/cntLanguage'
      - $ref: '#/components/parameters/currency'
      - $ref: '#/components/parameters/preformatted'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  _metadata:
                    $ref: '#/components/schemas/MetaData'
                  data:
                    type: object
                    properties:
                      tours:
                        type: array
                        items:
                          $ref: '#/components/schemas/Tour'
        4XX:
          $ref: '#/components/responses/4XX'
        default:
          $ref: '#/components/responses/Default'
  /{version}/tours/{tour_id}/availability:
    get:
      operationId: tours-by-id-availability
      summary: Find availability of a tour.
      tags:
      - Tours
      parameters:
      - $ref: '#/components/parameters/version'
      - $ref: '#/components/parameters/tourId'
      - $ref: '#/components/parameters/cnt-language'
      responses:
        '200':
          $ref: '#/components/responses/AvailabilityResponse'
        4XX:
          $ref: '#/components/responses/4XX'
        default:
          $ref: '#/components/responses/Default'
  /{version}/tours/{tour_id}/options:
    get:
      operationId: ToursByIdOptions
      summary: Find all options of a tour.
      tags:
      - Tours
      parameters:
      - $ref: '#/components/parameters/version'
      - $ref: '#/components/parameters/tourId'
      - $ref: '#/components/parameters/cntLanguage'
      - $ref: '#/components/parameters/currency'
      - $ref: '#/components/parameters/dates'
      - $ref: '#/components/parameters/limit'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  _metadata:
                    $ref: '#/components/schemas/MetaData'
                  data:
                    type: object
                    properties:
                      tour_options:
                        type: array
                        items:
                          $ref: '#/components/schemas/TourOption'
        4XX:
          $ref: '#/components/responses/4XX'
        default:
          $ref: '#/components/responses/Default'
  /{version}/tours/{tour_id}/price-breakdown:
    post:
      operationId: tours-by-id-price-breakdown
      description: Find pricing information for a tour by date.
      tags:
      - Tours
      parameters:
      - $ref: '#/components/parameters/version'
      - $ref: '#/components/parameters/tourId'
      requestBody:
        $ref: '#/components/requestBodies/DayBreakdownRequestBody'
      responses:
        '200':
          $ref: '#/components/responses/DayBreakdownResponse'
        4XX:
          $ref: '#/components/responses/4XX'
        default:
          $ref: '#/components/responses/Default'
components:
  schemas:
    BoundingBox:
      type: object
      properties:
        sw_lat:
          type: number
          format: double
        sw_long:
          type: number
          format: double
        ne_lat:
          type: number
          format: double
        ne_long:
          type: number
          format: double
    Language:
      type: string
      description: ISO 639 formatted language
      example: en
    DayBreakdownRequest:
      type: object
      required:
      - base_data
      - data
      properties:
        base_data:
          type: object
          required:
          - currency
          properties:
            currency:
              $ref: '#/components/schemas/Currency'
        data:
          type: object
          required:
          - date
          - participants
          properties:
            date:
              $ref: '#/components/schemas/Date'
            participants:
              type: object
              additionalProperties:
                type: integer
              description: 'The key here is a ticket category, and the value is the number of participants. Possible keys:

                - adult

                - child

                - youth

                - infant

                - senior

                - student

                - eu_citizen

                - military

                - eu_citizen_student

                '
              example:
                adult: 10
            addons:
              type: array
              items:
                type: object
                required:
                - id
                - quantity
                properties:
                  id:
                    type: integer
                    format: int64
                    example: 9291
                  quantity:
                    type: integer
                    description: Number of addons to calculate price.
                    example: 10
    Special:
      type: object
      properties:
        original_price:
          $ref: '#/components/schemas/PriceField'
        savings:
          type: number
          description: The maximum possible discount in percent.
          example: 12
        apps_only:
          type: boolean
          description: Flag if the special offer is only available for the GYG internal mobile apps.
    GroupPriceBreakdown:
      type: object
      required:
      - category_id
      - group_breakdown
      properties:
        category_id:
          type: integer
          description: The value to use when adding the group participants to the booking.
          format: int64
          example: 1
        group_breakdown:
          $ref: '#/components/schemas/GroupBreakdown'
        additional_pax_breakdown:
          $ref: '#/components/schemas/AdditionalPaxBreakdown'
    AdditionalPaxBreakdown:
      type: object
      required:
      - max_group_size
      - quantity
      - price
      properties:
        quantity:
          type: integer
          description: Number of individual/group participants, or addon items.
          example: 5
        price:
          $ref: '#/components/schemas/Price'
        deal_information:
          $ref: '#/components/schemas/DealInformation'
    CategoryId:
      description: ID of the category.
      example: 33
      type: integer
    OpeningHour:
      type: object
      required:
      - from
      - to
      properties:
        from:
          type: string
          example: '14:00'
        to:
          type: string
          example: '18:00'
    Picture:
      description: Picture
      type: object
      properties:
        id:
          type: integer
          description: Picture id.
          example: 66317
        url:
          type: string
          description: The URL string for the image. Important, The [format_id] needs to be replaced by a valid format id. You can find the list of all available IDs in the github wiki.
          example: https://img-getyourguide-com.partner.gygtest.com/img/tour_img-436036-[format_id].jpg
        ssl_url:
          type: string
          description: The URL string for the image. Important, The [format_id] needs to be replaced by a valid format id. You can find the list of all available IDs in the github wiki.
          example: https://img-getyourguide-com.partner.gygtest.com/img/tour_img-436036-[format_id].jpg
        verified:
          type: boolean
          description: Indicates if the image is verified by GetYourGuide
          example: false
        copyright:
          type: string
          description: Information on the copyright of the image
          example: Copyrights of this image belongs to ACME Inc
          nullable: true
    Validity:
      type: number
      format: float
      description: Validity period of the booking (to be used in combination with validity unit). Represents how long the ticket/voucher remains valid after booking or activation.
      example: 30
    OptionId:
      description: The ID of the tour option.
      example: 69232
      type: integer
    ValidityFrom:
      type: string
      description: When the validity period starts counting from.
      enum:
      - time_booked
      - time_selected
      - time_activated
      example: time_booked
    Durations:
      type: object
      properties:
        duration:
          $ref: '#/components/schemas/Duration'
        unit:
          $ref: '#/components/schemas/DurationUnit'
    Option:
      type: object
      required:
      - option_id
      - time_slots
      properties:
        option_id:
          type: integer
          format: int64
          example: 1231
        next_available_date:
          type: string
          format: date
          description: Next available date for the option, in case no timeslots could be found for a given date and participants.
        opening_hours:
          description: This field is show if the given product does not offer fixed time slots, but has opening hours for which a ticket will be valid.
          nullable: true
          type: array
          items:
            $ref: '#/components/schemas/OpeningHour'
        time_slots:
          type: array
          items:
            $ref: '#/components/schemas/TimeSlot'
    TourCategoryMinimal:
      description: A minimal representation of a tour category. More information about each category can be retrieved from the `/categories` endpoint.
      type: object
      properties:
        category_id:
          $ref: '#/components/schemas/CategoryId'
        name:
          type: string
          description: Name of the category.
          example: Theme Parks & Amusement Parks
    ItineraryItemLocation:
      description: Location of an itinerary stop.
      type: object
      properties:
        name:
          type: string
          nullable: true
          description: Display name of the location.
          example: Colosseum
        coordinates:
          $ref: '#/components/schemas/Coordinates'
    ItineraryItemDuration:
      description: How long a stop lasts.
      type: object
      properties:
        value:
          type: number
          format: float
          nullable: true
          description: Numeric duration value.
          example: 1.5
        unit:
          type: string
          nullable: true
          enum:
          - day
          - hour
          - minute
          description: Time unit for the duration value.
          example: hour
    TransportationType:
      type: object
      required:
      - mode
      properties:
        mode:
          type: string
          description: 'Possible values:

            - bicycle

            - mountain_bike

            - electric_bicycle

            - motorcycle

            - scooter

            - segway

            - car

            - limousine

            - jeep_suv

            - van

            - quad_atv

            - bus_coach

            - electric_car

            - vintage_car

            - black_cab

            - sailboat

            - ferry

            - gondola

            - duck_boat

            - jet_ski

            - sightseeing_cruise

            - water_taxi

            - river_boat

            - kayak

            - raft

            - catamaran

            - speed_boat

            - yacht

            - canoe

            - stand_up_paddle_board

            - surfboard

            - submarine

            - other_water_transport

            - train

            - tram

            - helicopter

            - airplane

            - balloon

            - glider

            - cable_car

            - pedicab_rickshaw

            - horse_carriage

            - camel

            - snowmobile

            - sled

            - other_animal

            - public

            - glass_bottom_boat

            - lake_cruise

            - banana_boat

            - beer_boat

            - air_boat

            - dhow

            - subway

            - beer_bike

            - trike

            - tuk_tuk

            - golf_cart

            - motorized_tuk_tuk

            - on_foot

            - horse

            - trolley

            '
    Error:
      type: object
      properties:
        descriptor:
          type: string
          example: GetYourGuide AG
        apiVersion:
          type: string
          example: '1'
        method:
          type: string
          example: getBookingByHashAction
        date:
          $ref: '#/components/schemas/Datetime'
        status:
          type: string
          example: ERROR
        query:
          type: string
          example: cnt_language=en&currency=eur
        errors:
          type: array
          items:
            type: object
            properties:
              errorCode:
                description: GetYourGuide internal error code
                type: integer
                format: int32
                example: 25
              errorMessage:
                description: Verbose description of the error.
                type: string
                example: Unauthorized. The access token is invalid.
        helpURL:
          type: string
          example: https://api.getyourguide.com/doc
    CntLanguage:
      description: ISO 639, Language of the text content.
      enum:
      - ar
      - ca
      - cs
      - da
      - de
      - el
      - en
      - es
      - et
      - fi
      - fr
      - he
      - hr
      - hu
      - id
      - it
      - ja
      - ko
      - lt
      - lv
      - ms
      - nl
      - 'no'
      - pl
      - pt
      - ro
      - ru
      - sk
      - sv
      - th
      - tr
      - zh
      - zh-hant
      example: en
      type: string
    Tour:
      description: A tour is a product.
      type: object
      properties:
        tour_id:
          $ref: '#/components/schemas/TourId'
        tour_code:
          deprecated: true
          type: string
          description: Deprecated field, does not contain any meaningful information.
          example: deprecated
        cond_language:
          type: array
          description: Available conduction languages.
          items:
            $ref: '#/components/schemas/Language'
          example:
          - en
          - de
          - es
        title:
          type: string
          description: Title of the option.
          example: 2-Park 2-Day Universal Orlando™ Theme Park Tickets
        abstract:
          type: string
          description: Short description of the tour.
          example: Universal Orlando Resort is an entire universe of action and thrills with two jaw-dropping theme parks, exceptional shopping and incredible entere unforgettable experiences together. You can have the ultimate adventure, enjoy fun with your kids, rejuvenatainment
        description:
          type: string
          description: Long description of the tour.
          example: At both Universal Studios Florida and Universal's Islands of Adventure ... The ticket must be used by the first use date printed on the ticket. The ticket will expire in full on the expiration date printed on ticket. Unused days shall be forfeited. These tickets are not valid for residents of the UK and Ireland
        is_auto_translation:
          type: boolean
          description: Flag if the title, abstract, description, … are auto-translated.
          example: false
        is_english_fallback:
          type: boolean
          description: Flag if the title, abstract, description, … are English since we don't have the translation yet.
          example: false
        additional_information:
          type: string
          description: Additional information for the customer.
          example: Tickets must be used by the same person on all days...you must present the actual Universal Orlando ticket to receive entry to the parks.
        items_to_bring:
          type: array
          description: Recommended items the customer should bring.
          items:
            type: string
          example:
          - Comfortable shoes
          - Sunscreen
        not_allowed:
          type: array
          description: Things that are not allowed to bring to the activity.
          items:
            type: string
          example:
          - Alcohol
          - Pets
        not_suitable_for:
          type: array
          description: Certain demographics for whom this activity is not suitable.
          items:
            type: string
          example:
          - Children under 3 years
          - People with impeded movement.
        bestseller:
          type: boolean
          description: Flag if the tour is a bestseller.
          example: false
        certified:
          type: boolean
          description: Flag if the tour is a certified tour.
          example: true
        has_pick_up:
          type: boolean
          description: Indicates if pickup is available for this product
          example: true
        overall_rating:
          $ref: '#/components/schemas/Rating'
        number_of_ratings:
          type: integer
          description: Number of rating of the tour.
          example: 25
        highlights:
          type: array
          description: List of highlights of that tour.
          items:
            type: string
        inclusions:
          type: string
          description: What's included in the tour.
          example: • Entry to both Universal Studios Florida and Universal’s Islands of Adventure for 2-days
        exclusions:
          type: string
          description: What's not included in the tour.
          example: Parking
        pictures:
          type: array
          items:
            $ref: '#/components/schemas/Picture'
        coordinates:
          $ref: '#/components/schemas/Coordinates'
        price:
          oneOf:
          - $ref: '#/components/schemas/StartingPrice'
          - $ref: '#/components/schemas/StartingPriceDiscounted'
        categories:
          description: List of tour categories tagged to this tour.
          type: array
          items:
            $ref: '#/components/schemas/TourCategoryMinimal'
        health_advisory:
          $ref: '#/components/schemas/HealthAdvisory'
        health_requirement:
          $ref: '#/components/schemas/HealthRequirement'
        locations:
          description: List of locations ordered according to importance.
          type: array
          items:
            $ref: '#/components/schemas/Location'
        url:
          type: string
          format: uri
          description: URL of the tour on the GetYourGuide website.
          example: https://www-getyourguide-com.partner.gygtest.com/orlando-l191/walt-disney-world-orlando-with-ticket-options-t50872/?partner_id=173E8&psrc=partner_api¤cy=EUR
        translations:
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/Language'
        free_sale:
          type: boolean
          description: Indicates whether there exists at least one tour option of which the booking engine is free-sale (i.e. whether a booking does not require confirmation by the supplier).
        guide_type:
          type: string
          enum:
          - none
          - host_greeter
          - instructor
          - driver
          - live_tour_guide
          - self_guided
          description: "Type of guide that is conducting the tour, available are\n  * `none`: no guide available for this tour.\n  * `host_greeter`: a host or greeter that welcomes the customer.\n  * `instructor`: an instructor e.g. for diving classes.\n  * `driver`: a driver for motorized tours.\n  * `live_tour_guide`: a standard live tour guide.\n  * `self_guided`: tour conducted without a guide; the customer explores on their own.\n"
        mobile_voucher:
          type: boolean
          description: If the tour accepts mobile voucher.
          example: true
        supplier_id:
          $ref: '#/components/schemas/SupplierId'
        durations:
          type: array
          items:
            $ref: '#/components/schemas/Durations'
        opening_hours:
          description: A list of opening hours for a given attraction or venue in local time.
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/OpeningHours'
        cancellation_policy:
          $ref: '#/components/schemas/CancellationPolicy'
        cancellation_policy_text:
          $ref: '#/components/schemas/CancellationPolicyText'
        itineraries:
          type: array
          nullable: true
          description: Structured itinerary describing the ordered stops/days of the tour. May be null or empty for tours without structured itinerary data.
          items:
            $ref: '#/components/schemas/Itinerary'
    Currency:
      description: ISO 4217, The currency with which you would like to pay.
      enum:
      - AED
      - ARS
      - AUD
      - BGN
      - CAD
      - CHF
      - CLP
      - CNY
      - COP
      - CZK
      - DKK
      - EGP
      - EUR
      - GBP
      - HKD
      - HRK
      - HUF
      - IDR
      - ILS
      - INR
      - JPY
      - KRW
      - MAD
      - MXN
      - MYR
      - NOK
      - NZD
      - PHP
      - PLN
      - RON
      - RUB
      - SEK
      - SGD
      - THB
      - TRY
      - UAH
      - USD
      - UYU
      - VND
      - ZAR
      example: USD
      type: string
    HealthRequirement:
      deprecated: true
      type: array
      items:
        type: object
        properties:
          tag_id:
            type: integer
            description: Tag Id
            example: 161578
          name:
            type: string
            description: Tag name
            example: Mask_required
          text:
            type: string
            description: Verbose description
            example: You are required to bring and wear a mask
    Version:
      description: The version of the API, currently only 1 is available.
      example: '1'
      type: string
      format: integer
    StartingPrice:
      type: object
      description: Starting price. Should be read as e.g. "from XX.YY USD.
      properties:
        values:
          type: object
          properties:
            amount:
              $ref: '#/components/schemas/PriceField'
        description:
          type: string
          description: Additional information about the pricing. E.g. 'per group' or 'per person' or 'per Group up to 10 people'.
          example: individual
    Location:
      type: object
      properties:
        location_id:
          description: Location ID
          type: integer
          example: 3850
        type:
          description: Location type
          type: string
          enum:
          - area
          - city
          - poi
          - subcontinent
          - country
          - neighborhood
          - continent
          example: poi
        name:
          type: string
          description: Name of the location.
          example: Epcot Theme Park
        english_name:
          description: DEPRECATED, always the same as the `name` field
          type: string
          example: Epcot Theme Park
        city:
          description: The city name if location type is poi or city.
          type: string
          nullable: true
        country:
          $ref: '#/components/schemas/Country'
        coordinates:
          $ref: '#/components/schemas/Coordinates'
        parent_id:
          description: The location id of the parent location, if there is any.
          type: integer
          example: 191
    Itinerary:
      description: A single day (or the only day) of a tour's itinerary. Single-day tours have one entry; multi-day tours have N entries ordered by day_number.
      type: object
      properties:
        day_number:
          type: integer
          nullable: true
          description: 1-indexed day number. Null for single-day tours.
          example: 1
        title:
          type: string
          nullable: true
          description: 'Display title for this day, e.g. "Day 1: Arrival in Cusco".'
          example: 'Day 1: Arrival in Cusco'
        items:
          type: array
          description: Ordered list of stops/activities for this day.
          items:
            $ref: '#/components/schemas/ItineraryItem'
    DealInformation:
      type: object
      required:
      - date_range
      properties:
        deal_percentage:
          type: number
          format: float
          description: Percentage of the applied deal.
          example: 20
        deal_booked_vacancies:
          type: integer
          description: Number of seats of the order to which the deal has been applied.
          example: 5
        date_range:
          $ref: '#/components/schemas/LocalDateRange'
    FreeSale:
      type: boolean
      description: Indicates whether if the tour option's booking engine is free-sale (i.e. whether a booking does not require confirmation by the supplier).
      example: true
    Limit:
      description: Number of items to retrieve.
      type: integer
      minimum: 1
      maximum: 500
      default: 10
      example: 10
    AvailableDate:
      type: object
      required:
      - date
      - has_deal
      properties:
        date:
          type: string
          format: date
        has_deal:
          description: Flag that indicates whether there is a special offer for this date.
          type: boolean
          example: true
    ParticipantCategory:
      type: object
      required:
      - ticket_category
      - name
      properties:
        ticket_category:
          type: string
          example: adult
          description: 'Possible values:

            - infant

            - child

            - youth

            - student

            - eu_citizen_student

            - adult

            - eu_citizen

            - military

            - senior

            - group

            '
        name:
          type: string
          example: Adults
        age_range:
          $ref: '#/components/schemas/IntegerRange'
        independently_bookable:
          description: Only relevant for non-group categories
          type: boolean
          example: true
    PriceSummary:
      type: object
      required:
      - retail_price
      - currency
      properties:
        retail_price:
          type: number
          example: 50
          description: The price for which the tour option was sold to the customer.
        currency:
          type: string
          description: ISO 4217, The currency with which you would like to pay.
          example: USD
    Flags:
      description: Various flags about properties of the tour (multiple selection allowed).
      type: string
      enum:
      - private
      - wheelchair
      - skip-line
      - pick-up
      - special
      - free-sale-only
      - mobile-voucher-only
    LocalDateRange:
      type: object
      properties:
        start:
          type: string
          format: date
        end:
          type: string
          format: date
    TourId:
      description: The ID of the tour.
      example: 50872
      type: integer
    AddonPriceBreakdown:
      type: object
      required:
      - category_id
      - quantity
      - price
      properties:
        category_id:
          type: integer
          description: The value to use when adding the addon to the booking.
          format: int64
          example: 1241
        quantity:
          type: integer
          description: Number of individual/group participants, or addon items.
          example: 5
        price:
          $ref: '#/components/schemas/Price'
    PickUpLocation:
      type: object
      required:
      - type
      properties:
        type:
          type: string
          description: 'Indicates the source type for pickup. Possible values:

            - from_areas

            - from_locations

            '
        description:
          description: Description of the pick up location translated to the language of the user.
          example: Pick up from your hotel in Manhattan
          type: string
        areas:
          type: array
          description: Provide this if type is 'from_areas'.
          items:
            $ref: '#/components/schemas/LogisticsArea'
        locations:
          type: array
          description: Provide this if type is 'from_locations'.
          items:
            $ref: '#/components/schemas/LogisticsLocation'
        transportation_types:
          type: array
          items:
            $ref: '#/components/schemas/TransportationType'
    TimeSlot:
      type: object
      required:
      - date_time
      - vacancies
      properties:
        date_time:
          type: string
          example: '2023-03-01T00:00:00'
          description: Tour-option conduction date, it will be midnight of the conduction date if the activity uses opening hours format `Y-m-d T H:i:s`.
        vacancies:
          type: integer
          example: 10
        unavailability_reason:
          $ref: '#/components/schemas/UnavailabilityReason'
        price_breakdown:
          $ref: '#/components/schemas/PriceBreakdown'
    IntegerRange:
      type: object
      properties:
        min:
          type: integer
          description: Minimum value of the range.
          example: 1
        max:
          type: integer
          description: Maximum value of the range.
          example: 20
    HealthAdvisory:
      type: array
      deprecated: true
      items:
        type: object
        properties:
          tag_id:
            type: integer
            description: Tag Id
            example: 161578
          name:
            type: string
  

# --- truncated at 32 KB (62 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/getyourguide/refs/heads/main/openapi/getyourguide-tours-api-openapi.yml