openapi: 3.0.1
info:
  title: Rapid
  description: Rapid Common APIs
  version: v1
  x-eg-lifecycle: LIVE
servers:
- url: https://test.ean.com
- url: https://api.ean.com
tags:
- name: Authentication
  description: This section outlines the API calls available to you to authenticate
    with Rapid.
- name: Typeahead
  description: |
    This section outlines the API calls available to you for providing typeahead location behavior on your site.
paths:
  /identity/oauth2/v3/token:
    post:
      tags:
      - Authentication
      summary: Opaque OAuth2 Authentication
      description: |
        OAuth2 authentication allows you to authenticate periodically rather than sending your credentials with every
        request. Once you have authenticated, you will receive an access token. The access token can be used on
        subsequent API calls to maintain access until it expires.</br></br>
        When the access token expires, you will receive an error letting you know that it has expired. To avoid seeing
        this error, we recommend you retrieve a new token several seconds before the token expires. The `expires_in`
        attribute in the response indicates the number of seconds a token is valid.
      operationId: createOAuthToken
      parameters:
      - name: Accept
        in: header
        description: |
          Specifies the response format that the client would like to receive back. This must be `application/json`.
        required: true
        style: simple
        explode: false
        schema:
          type: string
        example: application/json
      - name: Accept-Encoding
        in: header
        description: |
          Specifies the response encoding that the client would like to receive back. This must be `gzip`.
        required: true
        style: simple
        explode: false
        schema:
          type: string
        example: gzip
      - name: Authorization
        in: header
        description: |
          The custom generated authentication header. Format `Basic {encoded}` where `{encoded}` is the string
          `apikey:shared_secret` base64 encoded.
        required: true
        style: simple
        explode: false
        schema:
          type: string
        example: |
          Basic bXlzcGVjaWFsYXBpa2V5Om15c2hhcmVkc2VjcmV0
      - name: Content-Type
        in: header
        description: |
          This parameter is to specify what format the request body is in. The only supported value is
          application/x-www-form-urlencoded.
        required: true
        style: simple
        explode: false
        schema:
          type: string
        example: application/x-www-form-urlencoded
      - name: grant_type
        in: query
        description: |
          This parameter is to specify the OAuth grant_type expected.
        required: true
        style: form
        explode: true
        schema:
          type: string
          enum:
          - client_credentials
        example: client_credentials
      responses:
        "200":
          description: The OAuth2 access token response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  access_token:
                    type: string
                    description: The access token that can be used for subsequent
                      API calls.
                  token_type:
                    type: string
                    description: The type of access token being returned.
                  expires_in:
                    type: number
                    description: The number of seconds before the access token expires.
                  scope:
                    type: string
                    description: "The list of permission scopes assigned to the token,\
                      \ separated by spaces."
              examples:
                Basic:
                  value:
                    access_token: xxxExampleValueLTg5ZDQtYzNiN2ZiMDMx
                    token_type: Bearer
                    expires_in: 1799
                    scope: prod.all test.all
        "400":
          description: Invalid Request
          headers:
            Rate-Limit-Day:
              description: Reserved for future use. Optional header for request capacity
                per day.
              style: simple
              explode: false
              schema:
                type: number
            Rate-Limit-Day-Remaining:
              description: |
                Optional header for the remaining capacity, as a percentage, for the daily time window.
              style: simple
              explode: false
              schema:
                type: number
            Rate-Limit-Day-Reset:
              description: |
                Optional header for the timestamp, as the number of milliseconds since the Unix Epoch, when the daily
                capacity resets.
              style: simple
              explode: false
              schema:
                type: number
            Rate-Limit-Minute:
              description: Reserved for future use. Optional header for request capacity
                per minute.
              style: simple
              explode: false
              schema:
                type: number
            Rate-Limit-Minute-Remaining:
              description: |
                Optional header for the remaining capacity, as a percentage, for the per minute time window.
              style: simple
              explode: false
              schema:
                type: number
            Rate-Limit-Minute-Reset:
              description: |
                Optional header for the timestamp, as the number of milliseconds since the Unix Epoch, when the per
                minute capacity resets.
              style: simple
              explode: false
              schema:
                type: number
            Rate-Limit-Reduction-Status:
              description: |
                Optional header that indicates the state (inactive, active) of minute capacity reduction triggered once
                all daily capacity has been used.
              style: simple
              explode: false
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                type: invalid_input
                message: |
                  An invalid request was sent in, please check the nested errors for details.
                errors:
                - type: grant_type.invalid
                  message: |
                    Grant type is not supported. Supported grant types: [ client_credentials ]
                  fields:
                    name: grant_type
                    type: querystring
                    value: bad_type
        "401":
          description: Unauthorized
          headers:
            WWW-Authenticate:
              description: Provides an example of the Authorization header.
              style: simple
              explode: false
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                type: request_unauthenticated
                message: |
                  Data required to authenticate your request is missing or inaccurate. Ensure that your request follows
                  the guidelines in our documentation.
        "426":
          description: Upgrade Required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                type: upgrade_required
                message: This service requires the use of TLS.
        "429":
          description: Too Many Requests
          headers:
            Rate-Limit-Day:
              description: Reserved for future use. Optional header for request capacity
                per day.
              style: simple
              explode: false
              schema:
                type: number
            Rate-Limit-Day-Remaining:
              description: |
                Optional header for the remaining capacity, as a percentage, for the daily time window.
              style: simple
              explode: false
              schema:
                type: number
            Rate-Limit-Day-Reset:
              description: |
                Optional header for the timestamp, as the number of milliseconds since the Unix Epoch, when the daily
                capacity resets.
              style: simple
              explode: false
              schema:
                type: number
            Rate-Limit-Minute:
              description: Reserved for future use. Optional header for request capacity
                per minute.
              style: simple
              explode: false
              schema:
                type: number
            Rate-Limit-Minute-Remaining:
              description: |
                Optional header for the remaining capacity, as a percentage, for the per minute time window.
              style: simple
              explode: false
              schema:
                type: number
            Rate-Limit-Minute-Reset:
              description: |
                Optional header for the timestamp, as the number of milliseconds since the Unix Epoch, when the per
                minute capacity resets.
              style: simple
              explode: false
              schema:
                type: number
            Rate-Limit-Reduction-Status:
              description: |
                Optional header that indicates the state (inactive, active) of minute capacity reduction triggered once
                all daily capacity has been used.
              style: simple
              explode: false
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                type: too_many_requests
                message: You have reached your capacity for this type of request.
        "500":
          description: Unknown Internal Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                type: unknown_internal_error
                message: An internal server error has occurred.
        "503":
          description: Service Unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                type: service_unavailable
                message: This service is currently unavailable.
  /v3/suggestions:
    get:
      tags:
      - Typeahead
      summary: Suggestions
      description: |
        Returns a list of suggestions based on partial search strings as a user may input into a text field.
        The types of suggestions returned are controlled by the request parameters.
      operationId: getSuggestions
      parameters:
      - name: Accept
        in: header
        description: |
          Specifies the response format that the client would like to receive back. This must be `application/json`.
        required: true
        style: simple
        explode: false
        schema:
          type: string
        example: application/json
      - name: Accept-Encoding
        in: header
        description: |
          Specifies the response encoding that the client would like to receive back. This must be `gzip`.
        required: true
        style: simple
        explode: false
        schema:
          type: string
        example: gzip
      - name: User-Agent
        in: header
        description: |
          The `User-Agent` header string from the customer's request, as captured by your integration. If you are
          building an application then the `User-Agent` value should be `{app name}/{app version}`.
        required: true
        style: simple
        explode: false
        schema:
          type: string
        example: TravelNow/3.30.112
      - name: Customer-Session-Id
        in: header
        description: |
          Insert your own unique value for each user session, beginning with the first API call. Continue to pass the
          same value for each subsequent API call during the user's session, using a new value for every new customer
          session.<br>
          Including this value greatly eases EPS's internal debugging process for issues with partner requests, as it
          explicitly links together request paths for individual user's session.
        required: false
        style: simple
        explode: false
        schema:
          type: string
      - name: language
        in: query
        description: |
          Desired language for the response as a subset of BCP47 format that only uses hyphenated pairs of two-digit
          language and country codes. Use only ISO 639-1 alpha-2 language codes and ISO 3166-1 alpha-2 country codes.
          See [https://www.w3.org/International/articles/language-tags/](https://www.w3.org/International/articles/language-tags/)
        required: true
        style: form
        explode: true
        schema:
          type: string
        examples:
          English:
            value: en-US
          Cantonese:
            value: zh-HK
      - name: text
        in: query
        description: |
          Search string used to calculate list of suggestions. Max 150 characters.
        required: true
        style: form
        explode: true
        schema:
          type: string
        example: springf
      - name: feature
        in: query
        description: |
          Features that change the calculation of the suggestion results.
          * `hierarchy` - Enables the return of sub-results, such as when a metro area has multiple airports.
          * `nearby_airport` - Enables the returning of airports near the search results even when they don't directly
            match the search term.
          * `postal_code` - Enables matching search terms on Postal Codes.
        required: false
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
            enum:
            - hierarchy
            - nearby_airport
            - postal_code
        examples:
          Optional:
            value: null
          Single:
            value: nearby_airport
          Multiple:
            value:
            - hierarchy
            - nearby_airport
      - name: limit
        in: query
        description: |
          Limit the number of results returned. Default value is 10. Min: 1, Max: 10
        required: false
        style: form
        explode: true
        schema:
          type: string
        examples:
          Optional:
            value: null
          Limited:
            value: 5
      - name: line_of_business
        in: query
        description: |
          This parameter provides search heuristics, and a valid value ensures the response will be more relevant.
          * `properties` - Provides results that are optimized for beginning a Property or Lodging search. *Default*
          * `activities` - Provides results that are optimized for beginning an Activities search.
          * `cars` - Provides results that are optimized for beginning a Cars search.
          * `flights` - Provides results that are optimized for beginning a Flights search.
          * `packages` - Provides results that are optimized for beginning a multiple line of business search. Used in
            conjunction with the `package_type` field to further optimize the search.
        required: false
        style: form
        explode: true
        schema:
          type: string
          enum:
          - properties
          - activities
          - cars
          - flights
          - packages
        examples:
          Optional:
            value: null
          Properties:
            value: properties
      - name: origin
        in: query
        description: Specifies whether the query text is an origin instead of a destination.
        required: false
        style: form
        explode: true
        schema:
          type: boolean
        examples:
          Optional:
            value: null
          Destination:
            value: false
          Origin:
            value: true
      - name: package_type
        in: query
        description: |
          Package Types that accompany the `packages` line of business.
          * `flight_property` - Optimized results for when the package targeted is Flight + Property
          * `flight_property_car` - Optimized results for when the package targeted is Flight + Property + Car
          * `flight_car` - Optimized results for when the package targeted is Flight + Car
          * `property_car` - Optimized results for when the package targeted is Property + Car
        required: false
        style: form
        explode: true
        schema:
          type: string
          enum:
          - flight_property
          - flight_property_car
          - flight_car
          - property_car
        examples:
          Optional:
            value: null
          Package:
            value: flight_property
      - name: region_id
        in: query
        description: Filter the results to properties with the specified region.
        required: false
        style: form
        explode: true
        schema:
          type: string
        examples:
          Optional:
            value: null
          Region:
            value: 602962
      - name: type
        in: query
        description: |
          Filter the results to a specified type. This parameter can be supplied multiple times with different values.
          * `address` - Results will include Address suggestions.
          * `airport` - Results will include Airport suggestions.
          * `airport_metro_code` - Results will include Airport Metro Code (eg. QLA or NYC) suggestions.
          * `bus_station` - Results will include Bus Station suggestions.
          * `city` - Results will include City suggestions.
          * `metro_station` - Results will include Metro Station suggestions.
          * `multi_city_vicinity` - Results will include Multi City Vicinity (eg Minneapolis - St. Paul) suggestions.
          * `multi_region` - Results will include Multi Region suggestions. These can include multiple sub types.
          * `neighborhood` - Results will include Neighborhood suggestions.
          * `point_of_interest` - Results will include Point of Interest (POI) suggestions.
          * `property` - Results will include Property suggestions.
          * `train_station` - Results will include Train Station suggestions.
        required: false
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
            enum:
            - address
            - airport
            - airport_metro_code
            - bus_station
            - city
            - metro_station
            - multi_city_vicinity
            - multi_region
            - neighborhood
            - point_of_interest
            - property
            - train_station
        examples:
          Optional:
            value: null
          Property Only:
            value: property
          Multiple Types:
            value:
            - airport
            - city
            - multi_city_vicinity
      responses:
        "200":
          description: OK
          headers:
            Rate-Limit-Day:
              description: Reserved for future use. Optional header for request capacity
                per day.
              style: simple
              explode: false
              schema:
                type: number
            Rate-Limit-Day-Remaining:
              description: "Optional header for the remaining capacity, as a percentage,\
                \ for the daily time window."
              style: simple
              explode: false
              schema:
                type: number
            Rate-Limit-Day-Reset:
              description: "Optional header for the timestamp, as the number of milliseconds\
                \ since the Unix Epoch, when the daily capacity resets."
              style: simple
              explode: false
              schema:
                type: number
            Rate-Limit-Minute:
              description: Reserved for future use. Optional header for request capacity
                per minute.
              style: simple
              explode: false
              schema:
                type: number
            Rate-Limit-Minute-Remaining:
              description: "Optional header for the remaining capacity, as a percentage,\
                \ for the per minute time window."
              style: simple
              explode: false
              schema:
                type: number
            Rate-Limit-Minute-Reset:
              description: "Optional header for the timestamp, as the number of milliseconds\
                \ since the Unix Epoch, when the per minute capacity resets."
              style: simple
              explode: false
              schema:
                type: number
            Rate-Limit-Reduction-Status:
              description: "Optional header that indicates the state (inactive, active)\
                \ of minute capacity reduction triggered once all daily capacity has\
                \ been used."
              style: simple
              explode: false
              schema:
                type: string
            Region:
              $ref: '#/components/headers/Region'
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ParentSuggestion'
              examples:
                text = 'chicago' line_of_business = 'flights' feature = 'hierarchy' limit = 2:
                  value:
                  - related_id: "6139044"
                    type: airport_metro_code
                    name: "Chicago, IL (CHI-All Airports)"
                    name_full: "Chicago, IL, United States of America (CHI-All Airports)"
                    name_display: "<B>Chicago</B>, IL, United States of America (CHI-All\
                      \ Airports)"
                    country_code: US
                    country_code_3: USA
                    iata_airport_code: CHI
                    iata_airport_metro_code: CHI
                    coordinates:
                      latitude: 42.070841135126976
                      longitude: -88.65637437993698
                    related_suggestions:
                    - related_id: "4477519"
                      type: airport
                      name: "Chicago, IL (ORD-O'Hare Intl.)"
                      name_full: "Chicago, IL, United States of America (ORD-O'Hare\
                        \ Intl.)"
                      name_display: "<B>Chicago</B>, IL, United States of America\
                        \ (ORD-O'Hare Intl.)"
                      country_code: US
                      country_code_3: USA
                      iata_airport_code: ORD
                      iata_airport_metro_code: CHI
                      coordinates:
                        latitude: 41.976977
                        longitude: -87.90481
                      related_suggestion_types:
                      - child
                text = 'eiff' type = 'point_of_interest' limit = 2:
                  value:
                  - related_id: "502251"
                    type: point_of_interest
                    name: Eiffel Tower
                    name_full: "Eiffel Tower, Paris, France"
                    name_display: "<B>Eiff</B>el Tower, Paris, France"
                    country_code: FR
                    country_code_3: FRA
                    iata_airport_code: PAR
                    iata_airport_metro_code: PAR
                    coordinates:
                      latitude: 48.858262
                      longitude: 2.294496
                  - related_id: "6159651"
                    type: point_of_interest
                    name: Las Vegas Eiffel Tower
                    name_full: "Las Vegas Eiffel Tower, Paradise, Nevada, United States\
                      \ of America"
                    name_display: "Las Vegas <B>Eiff</B>el Tower, Paradise, Nevada,\
                      \ United States of America"
                    country_code: US
                    country_code_3: USA
                    iata_airport_code: LAS
                    iata_airport_metro_code: LAS
                    coordinates:
                      latitude: 36.1118
                      longitude: -115.17287
        "400":
          description: Bad Request
          headers:
            Rate-Limit-Day:
              description: Reserved for future use. Optional header for request capacity
                per day.
              style: simple
              explode: false
              schema:
                type: number
            Rate-Limit-Day-Remaining:
              description: "Optional header for the remaining capacity, as a percentage,\
                \ for the daily time window."
              style: simple
              explode: false
              schema:
                type: number
            Rate-Limit-Day-Reset:
              description: "Optional header for the timestamp, as the number of milliseconds\
                \ since the Unix Epoch, when the daily capacity resets."
              style: simple
              explode: false
              schema:
                type: number
            Rate-Limit-Minute:
              description: Reserved for future use. Optional header for request capacity
                per minute.
              style: simple
              explode: false
              schema:
                type: number
            Rate-Limit-Minute-Remaining:
              description: "Optional header for the remaining capacity, as a percentage,\
                \ for the per minute time window."
              style: simple
              explode: false
              schema:
                type: number
            Rate-Limit-Minute-Reset:
              description: "Optional header for the timestamp, as the number of milliseconds\
                \ since the Unix Epoch, when the per minute capacity resets."
              style: simple
              explode: false
              schema:
                type: number
            Rate-Limit-Reduction-Status:
              description: "Optional header that indicates the state (inactive, active)\
                \ of minute capacity reduction triggered once all daily capacity has\
                \ been used."
              style: simple
              explode: false
              schema:
                type: string
            Region:
              $ref: '#/components/headers/Region'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                type: invalid_input
                message: "An invalid request was sent in, please check the nested\
                  \ errors for details."
                errors:
                - type: text.required
                  message: Text is required.
        "401":
          description: Unauthorized
          headers:
            Region:
              $ref: '#/components/headers/Region'
            WWW-Authenticate:
              description: Provides an example of the Authorization header.
              style: simple
              explode: false
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                type: request_unauthenticated
                message: Data required to authenticate your request is missing or
                  inaccurate. Ensure that your request follows the guidelines in our
                  documentation.
                fields:
                - name: apikey
                  type: header
                  value: jaj3982k239dka328e
                - name: signature
                  type: header
                  value: 129d75332614a5bdbe0c7eb540e95a65f9d85a5b53dabb38d19b37fad6312a2bd25c12ee5a82831d55112087e1b
                - name: timestamp
                  type: header
                  value: 198284729
                - name: servertimestamp
                  type: server
                  value: 198284729
        "403":
          description: Forbidden
          headers:
            Region:
              $ref: '#/components/headers/Region'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                type: request_unauthorized
                message: Your request could not be authorized.
        "426":
          description: Upgrade Required
          headers:
            Region:
              $ref: '#/components/headers/Region'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                type: upgrade_required
                message: This service requires the use of TLS.
        "429":
          description: Too Many Requests
          headers:
            Rate-Limit-Day:
              description: Reserved for future use. Optional header for request capacity
                per day.
              style: simple
              explode: false
              schema:
                type: number
            Rate-Limit-Day-Remaining:
              description: "Optional header for the remaining capacity, as a percentage,\
                \ for the daily time window."
              style: simple
              explode: false
              schema:
                type: number
            Rate-Limit-Day-Reset:
              description: "Optional header for the timestamp, as the number of milliseconds\
                \ since the Unix Epoch, when the daily capacity resets."
              style: simple
              explode: false
              schema:
                type: number
            Rate-Limit-Minute:
              description: Reserved for future use. Optional header for request capacity
                per minute.
              style: simple
              explode: false
              schema:
                type: number
            Rate-Limit-Minute-Remaining:
              description: "Optional header for the remaining capacity, as a percentage,\
                \ for the per minute time window."
              style: simple
              explode: false
              schema:
                type: number
            Rate-Limit-Minute-Reset:
              description: "Optional header for the timestamp, as the number of milliseconds\
                \ since the Unix Epoch, when the per minute capacity resets."
              style: simple
              explode: false
              schema:
                type: number
            Rate-Limit-Reduction-Status:
              description: "Optional header that indicates the state (inactive, active)\
                \ of minute capacity reduction triggered once all daily capacity has\
                \ been used."
              style: simple
              explode: false
              schema:
                type: string
            Region:
              $ref: '#/components/headers/Region'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                type: too_many_requests
                message: You have reached your capacity for this type of request.
        "500":
          description: Unknown Internal Error
          headers:
            Region:
              $ref: '#/components/headers/Region'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                type: unknown_internal_error
                message: An internal server error has occurred.
        "503":
          description: Service Unavailable
          headers:
            Region:
              $ref: '#/components/headers/Region'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                type: service_unavailable
                message: This service is currently unavailable.
      security:
      - oauth: []
components:
  schemas:
    Error:
      type: object
      properties:
        type:
          type: string
          description: The error type.
        message:
          type: string
          description: A human readable message giving details about this error.
        fields:
          type: array
          description: Details about the specific fields that had an error.
          items:
            $ref: '#/components/schemas/Field'
        errors:
          type: array
          description: An array of all the actual errors that occured.
          items:
            $ref: '#/components/schemas/ErrorIndividual'
      description: The overall class of error that occured.
    Field:
      type: object
      properties:
        name:
          type: string
          description: The field that had an error.
        type:
          type: string
          description: The type of the field that had an error.
        value:
          type: string
          description: The value of the field that had an error.
      description: An individual field that had an error.
    ErrorIndividual:
      type: object
      properties:
        type:
          type: string
          description: The error type.
        message:
          type: string
          description: A human readable message giving details about this error.
        fields:
          type: array
          description: Details about the specific fields that had an error.
          items:
            $ref: '#/components/schemas/Field'
      description: An individual error.
    ParentSuggestion:
      allOf:
      - $ref: '#/components/schemas/Suggestion'
      - type: object
        properties:
          related_suggestions:
            type: array
            description: A list of related suggestions
            items:
              $ref: '#/components/schemas/RelatedSuggestion'
    Suggestion:
      type: object
      properties:
        related_id:
          type: string
          description: This identifier can be used with the type field to look up
            information about this suggestion.
        type:
          type: string
          description: Type of the suggestion object.
        subtype:
          type: string
          description: "If available, this is a more specific type."
        name:
          type: string
          description: The name of the suggestion
          example: Springfield
        name_full:
          type: string
          description: The complete name of the suggestion.
          example: "Springfield, Massachusetts, United States of America"
        name_display:
          type: string
          description: The complete name of the suggestion with search query terms
            bolded.
          example: "<B>Springfield</B>, Massachusetts, United States of America"
        country_code:
          type: string
          description: "2-letter country code, in ISO 3166-1 alpha-2 format."
        country_code_3:
          type: string
          description: "3-letter country code, in ISO 3166-1 alpha-3 format."
        iata_airport_code:
          type: string
          description: 3-character IATA airport code
        iata_airport_metro_code:
          type: string
          description: 3-character IATA airport code of the metropolitan area
        coordinates:
          $ref: '#/components/schemas/Coordinates'
    Coordinates:
      type: object
      properties:
        latitude:
          type: number
        longitude:
          type: number
    RelatedSuggestion:
      allOf:
      - $ref: '#/components/schemas/Suggestion'
      - type: object
        properties:
          related_suggestion_types:
            type: array
            description: |
              List of terms that indicate how this result relates to the parent suggestion.
              * `child` - This result is a child of the parent suggestion (feature: `hierarchy`)
              * `nearby` - This result is nearby the parent suggestion (feature: `nearby_airport`)
            items:
              type: string
              example: nearby
  headers:
    Region:
      description: Optional header that provides information about where the request
        was processed.
      style: simple
      explode: false
      schema:
        type: string
        example: us-west-2
  securitySchemes:
    rapidAuth:
      type: apiKey
      description: "The custom generated authentication header. Refer to our [signature\
        \ authentication](https://developers.expediagroup.com/docs/rapid/resources/reference/signature-authentication)\
        \ page for full details."
      name: Authorization
      in: header
    oauth:
      type: oauth2
      description: |
        OAuth 2.0 compatible credentials, currently only available for use with the /suggestions endpoint
      flows:
        clientCredentials:
          tokenUrl: /identity/oauth2/v3/token?grant_type=client_credentials
          scopes: {}
