Transfer Search

Searches private and shared transfer options (taxi, limo, shuttle) between two locations with prices, vehicle types, and cancellation policies.

Documentation

Specifications

Examples

📝
Example
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/examples/transfer-search-address-common-example.json
📝
Example
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/examples/transfer-search-address-example.json
📝
Example
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/examples/transfer-search-baggage-example.json
📝
Example
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/examples/transfer-search-cancellation-rule-example.json
📝
Example
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/examples/transfer-search-contact-example.json
📝
Example
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/examples/transfer-search-discount-code-example.json
📝
Example
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/examples/transfer-search-distance-example.json
📝
Example
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/examples/transfer-search-equipment-example.json
📝
Example
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/examples/transfer-search-error-400-example.json
📝
Example
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/examples/transfer-search-error-401-example.json
📝
Example
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/examples/transfer-search-error-500-example.json
📝
Example
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/examples/transfer-search-extra-service-example.json
📝
Example
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/examples/transfer-search-issue-example.json
📝
Example
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/examples/transfer-search-location-example.json
📝
Example
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/examples/transfer-search-partner-info-example.json
📝
Example
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/examples/transfer-search-passenger-characteristics-example.json
📝
Example
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/examples/transfer-search-points-and-cash-example.json
📝
Example
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/examples/transfer-search-seat-example.json
📝
Example
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/examples/transfer-search-service-provider-example.json
📝
Example
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/examples/transfer-search-stop-over-example.json
📝
Example
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/examples/transfer-search-stop-over-request-example.json
📝
Example
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/examples/transfer-search-travel-segment-example.json
📝
Example
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/examples/transfer-search-travel-segment-location-example.json
📝
Example
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/examples/transfer-search-vehicle-example.json

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/transfer-search-address-common-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/transfer-search-address-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/transfer-search-baggage-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/transfer-search-cancellation-rule-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/transfer-search-contact-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/transfer-search-contact-with-address-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/transfer-search-discount-code-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/transfer-search-distance-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/transfer-search-equipment-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/transfer-search-error-400-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/transfer-search-error-401-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/transfer-search-error-500-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/transfer-search-extra-service-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/transfer-search-fee-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/transfer-search-issue-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/transfer-search-location-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/transfer-search-partner-info-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/transfer-search-passenger-characteristics-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/transfer-search-points-and-cash-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/transfer-search-quotation-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/transfer-search-seat-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/transfer-search-service-provider-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/transfer-search-stop-over-request-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/transfer-search-stop-over-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/transfer-search-tax-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/transfer-search-transfer-offer-post-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/transfer-search-transfer-offer-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/transfer-search-transportation-type-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/transfer-search-travel-segment-location-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/transfer-search-travel-segment-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/transfer-search-vehicle-schema.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/transfer-search-address-common-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/transfer-search-address-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/transfer-search-baggage-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/transfer-search-cancellation-rule-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/transfer-search-contact-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/transfer-search-contact-with-address-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/transfer-search-discount-code-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/transfer-search-distance-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/transfer-search-equipment-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/transfer-search-error-400-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/transfer-search-error-401-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/transfer-search-error-500-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/transfer-search-extra-service-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/transfer-search-fee-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/transfer-search-issue-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/transfer-search-location-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/transfer-search-partner-info-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/transfer-search-passenger-characteristics-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/transfer-search-points-and-cash-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/transfer-search-quotation-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/transfer-search-seat-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/transfer-search-service-provider-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/transfer-search-stop-over-request-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/transfer-search-stop-over-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/transfer-search-tax-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/transfer-search-transfer-offer-post-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/transfer-search-transfer-offer-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/transfer-search-transportation-type-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/transfer-search-travel-segment-location-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/transfer-search-travel-segment-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/transfer-search-vehicle-structure.json

OpenAPI Specification

amadeus-transfer-search-openapi.yml Raw ↑
swagger: '2.0'
info:
  version: 1.11.3
  title: Transfer Search
  description: |-
    Before using this API, we recommend you read our **[Authorization Guide](https://developers.amadeus.com/self-service/apis-docs/guides/authorization-262)** for more information on how to generate an access token. 

    Please also be aware that our test environment is based on a subset of the production for this API it may change dynamically. For your tests, use big cities like LON (London) or NYC (New-York).
host: test.api.amadeus.com
basePath: /v1
schemes:
  - https
consumes:
  - application/vnd.amadeus+json
  - application/json
produces:
  - application/vnd.amadeus+json
  - application/json
paths:
  /shopping/transfer-offers:
    post:
      tags:
        - Shopping
      operationId: getTransferOffers
      summary: Amadeus Gets Transfer Offers.
      parameters:
        - name: body
          in: body
          required: true
          schema:
            title: Body_TransferOffers
            type: object
            required:
              - startDateTime
              - startLocationCode
            properties:
              startDateTime:
                description: date and time specified in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) YYYY-MM-DDThh:mm:ss format e.g. 2017-11-10T10:00:00
                type: string
              passengers:
                description: the number of passengers, e.g. 3. Default value is 1
                type: integer
                default: 1
              startLocationCode:
                description: location from [IATA table codes](http://www.iata.org/publications/Pages/code-search.aspx), e.g. CDG. Location could be defined either using location code or address (address line, zip code, country code, city, geo code)
                type: string
              startUicCode:
                description: UIC code defined by the worldwide railway organization e.g. 8600626
                type: string
              startAddressLine:
                description: street address including building number, e.g. 5 Avenue Anatole France
                type: string
              startZipCode:
                description: postal/zip code, e.g. 75007
                type: string
              startCountryCode:
                description: country of the pick-up location with [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format (e.g. US)
                type: string
              startCityName:
                description: city name, e.g. Paris
                type: string
              startStateCode:
                description: state code according to [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)
                type: string
              startGeoCode:
                description: |-
                  latitude and longitude of geographical location following the structure {latitude},{longitude}
                  Example: 48.858093,2.294694
                type: string
              startName:
                description: place name e.g. Airport Name, Hotel Name etc.
                type: string
              startGooglePlaceId:
                description: google place id only for google address e.g. ChIJL-DOWeBv5kcRfTbh97PimNc.
                type: string
              endLocationCode:
                description: |-
                  location from [IATA table codes](http://www.iata.org/publications/Pages/code-search.aspx). Optional, for transferType = HOURLY. 
                  End location must be defined either using code (location code, UIC code, or GooglePlaceId) or address (address line, zip code, country code, city, geo code)
                type: string
                example: CDG
              endUicCode:
                description: |-
                  UIC code defined by the worldwide railway organization. 
                  End location must be defined either using code (location code, UIC code, or GooglePlaceId) or address (address line, zip code, country code, city, geo code)
                type: string
                example: '8600626'
              endAddressLine:
                description: |-
                  street address, e.g. 5 Avenue Anatole France. 
                  End location must be defined either using code (location code, UIC code, or GooglePlaceId) or address (address line, zip code, country code, city, geo code)
                type: string
              endZipCode:
                description: postal/zip code
                type: string
                example: '75007'
              endCountryCode:
                description: country of the location with [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format
                type: string
                example: US
              endCityName:
                description: city name
                type: string
                example: Paris
              endStateCode:
                description: state code according to [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)
                type: string
              endGeoCode:
                description: |-
                  latitude and longitude of geographical location following the structure {latitude},{longitude}
                  Example: 48.858093,2.294694
                type: string
              endName:
                description: place name e.g. Airport Name, Hotel Name etc.
                type: string
              endGooglePlaceId:
                description: |-
                  google place id only for google address. 
                  End location must be defined either using code (location code, UIC code, or GooglePlaceId) or address (address line, zip code, country code, city, geo code)
                type: string
                example: ChIJL-DOWeBv5kcRfTbh97PimNc
              transferType:
                type: string
                enum:
                  - PRIVATE
                  - SHARED
                  - TAXI
                  - HOURLY
                  - AIRPORT_EXPRESS
                  - AIRPORT_BUS
                description: |
                  a transfer service type
                  Example: PRIVATE

                  value           | description
                  --------------  | ------------------------
                  PRIVATE         | Private transfer from point to point
                  SHARED          | Shared transfer from point to point
                  TAXI            | Taxi reservation from point to point, price is estimated
                  HOURLY          | Chauffeured driven transfer per hour
                  AIRPORT_EXPRESS | Express Train from/to Airport
                  AIRPORT_BUS     | Express Bus from/to Airport

                  If not filled, all transfer service types are requested
              duration:
                description: transfer duration in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) PnYnMnDTnHnMnS format, e.g. PT2H10M. It is used and mandatory for transferType = HOURLY
                type: string
              language:
                description: code of the preferred language to be used in [ISO 639-1 alpha-2](https://en.wikipedia.org/wiki/ISO_639-1) format, e.g. EN
                type: string
                default: EN
              currency:
                description: the preferred currency for the transfer offers. Currency is specified in the [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format, e.g. EUR for Euro
                type: string
              vehicleCategory:
                type: string
                enum:
                  - ST
                  - BU
                  - FC
                description: |
                  a vehicle category
                  Example: BU

                  code  | name
                  ----- | -------------------------------------
                  ST    | Standard Class
                  BU    | Business Class
                  FC    | First Class

                  If not filled, all vehicle categories are requested
              vehicleCode:
                type: string
                enum:
                  - MBR
                  - CAR
                  - SED
                  - WGN
                  - ELC
                  - VAN
                  - SUV
                  - LMS
                  - TRN
                  - BUS
                description: |
                  a vehicle type code
                  Example: VAN

                  code   | name
                  ------ | -------------------------------------
                  MBK    | Motorcycle
                  CAR    | Car
                  SED    | Sedan
                  WGN    | Wagon
                  ELC    | Electric car
                  VAN    | Van or minivan
                  SUV    | Sport utility vehicle
                  LMS    | Limousine
                  TRN    | Train
                  BUS    | Bus

                  If not filled, all vehicle types are requested
              providerCodes:
                description: |-
                  transfer provider codes, comma-separated. If not filled, the request is sent to all providers
                  Example: TXO,FGT
                type: string
              baggages:
                description: the number of baggages to be supported by the vehicle. If specified, this number should be greater than or equal to 0
                type: integer
              discountNumbers:
                type: string
                description: |-
                  transfer provider discount numbers, which could be used to get negotiated or discounted rates. Comma separated array with the following structure: {providerCode}|{discountType}|{discountNumber}.
                  Example: ABC|CD|1122-DD-22, where providerCode=ABC, discountType=CD and discountNumber=1122-DD-22
                  Accepted discountType:  "CD" for corporate discount code, "PC" for promotional/campaign discount code
              extraServiceCodes:
                type: string
                description: |-
                  a comma-separated list of extra service codes
                  Example: EWT,MAG,FLM

                  code   | name
                  ------ | ----------------------------
                  DSL    | Driver language specified
                  EWT    | Extra waiting time
                  MAG    | Meet & Greet
                  FLM    | Flight monitoring
                  NWS    | Newspaper
                  CAI    | Cancellation insurance
                  WNR    | Wait and Return. Driver waits at destination and brings back the customer to pick-up point
              equipmentCodes:
                type: string
                description: |
                  a comma-separated list of extra equipment codes
                  Example: CBS,BYC

                  code   | name
                  ------ | -------------------------------------
                  BBS    | Baby stroller/Push chair
                  BYC    | Bicycle rack
                  CBB    | Cargo barrier rack
                  CBF    | Cargo barrier front
                  CBS    | Booster seat for child under 135cm or up to 12 years
                  CSB    | Child seat determined by weight/age of child 1-3 years / 9-18 Kg
                  CSI    | Child seat determined by weight/age of child 0-12 month/0-13Kg
                  CST    | Child seat determined by weight/age of child 4-7 years/15 – 30 Kg
                  SBR    | Snow board racks
                  SKB    | Ski box
                  SKR    | Ski rack
                  TAB    | Travel Tablet 
                  WAR    | Wheelchair access ramp
                  WHC    | Wheelchair
                  WIF    | Wi-Fi access
                  CNT    | Charger cable
              reference:
                description: reference of the Trip e.g. YNK4JQ
                type: string
              stopOvers:
                type: array
                description: Location of the stop over or the several stop over points. It can be defined either using IATA code or Address (address line, zip, country, city, state, latitude, longitude). Vehicle change via stop overs is not supported.
                items:
                  $ref: '#/definitions/StopOverRequest'
              startConnectedSegment:
                $ref: '#/definitions/TravelSegment'
              endConnectedSegment:
                $ref: '#/definitions/TravelSegment'
              passenegerCharacteristics:
                type: array
                description: Describes passenger typeCode and their age.
                items:
                  $ref: '#/definitions/PassengerCharacteristics'
            example: &id001
              startLocationCode: CDG
              endAddressLine: Avenue Anatole France, 5
              endCityName: Paris
              endZipCode: '75007'
              endCountryCode: FR
              endName: Souvenirs De La Tour
              endGeoCode: 48.859466,2.2976965
              transferType: PRIVATE
              startDateTime: '2024-04-10T10:30:00'
              passengers: 2
              stopOvers:
                - duration: PT2H30M
                  sequenceNumber: 1
                  addressLine: Avenue de la Bourdonnais, 19
                  countryCode: FR
                  cityName: Paris
                  zipCode: '75007'
                  name: De La Tours
                  geoCode: 48.859477,2.2976985
                  stateCode: FR
              startConnectedSegment:
                transportationType: FLIGHT
                transportationNumber: AF380
                departure:
                  localDateTime: '2024-04-10T09:00:00'
                  iataCode: NCE
                arrival:
                  localDateTime: '2024-04-10T10:00:00'
                  iataCode: CDG
              passengerCharacteristics:
                - passengerTypeCode: ADT
                  age: 20
                - passengerTypeCode: CHD
                  age: 10
          x-example: *id001
      responses:
        '200':
          $ref: '#/responses/transfer_offers_post'
        '400':
          $ref: '#/responses/400_postTransferOffers'
        '401':
          $ref: '#/responses/401'
        default:
          $ref: '#/responses/500'
      description: ''
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
definitions:
  TransferOffer:
    description: transfer offer
    allOf:
      - type: object
        required:
          - transferType
          - start
          - serviceProvider
          - vehicle
          - quotation
          - methodsOfPaymentAccepted
        properties:
          transferType:
            type: string
            enum:
              - PRIVATE
              - SHARED
              - TAXI
              - HOURLY
              - AIRPORT_EXPRESS
              - AIRPORT_BUS
            description: |
              amadeus transfer service type

              value           | description                                 
              --------------  | ------------------------
              PRIVATE         | Private transfer from point to point
              SHARED          | Shared transfer from point to point
              TAXI            | Taxi reservation from point to point, price is estimated
              HOURLY          | Chauffeured driven transfer per hour
              AIRPORT_EXPRESS | Express Train from/to Airport
              AIRPORT_BUS     | Express Bus from/to Airport
          start:
            $ref: '#/definitions/Location'
          end:
            $ref: '#/definitions/Location'
          stopOvers:
            type: array
            items:
              $ref: '#/definitions/StopOver'
          passenegerCharacteristics:
            type: array
            items:
              $ref: '#/definitions/PassengerCharacteristics'
          duration:
            description: transfer duration in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) PnYnMnDTnHnMnS format, e.g. PT2H10M
            type: string
            example: PT2H30M
          vehicle:
            $ref: '#/definitions/Vehicle'
          serviceProvider:
            $ref: '#/definitions/ServiceProvider'
          partnerInfo:
            $ref: '#/definitions/PartnerInfo'
          quotation:
            $ref: '#/definitions/Quotation'
          converted:
            $ref: '#/definitions/Quotation'
          extraServices:
            type: array
            items:
              $ref: '#/definitions/ExtraService'
          equipment:
            type: array
            items:
              $ref: '#/definitions/Equipment'
          cancellationRules:
            type: array
            items:
              $ref: '#/definitions/CancellationRule'
          methodsOfPaymentAccepted:
            type: array
            description: list of payment methods, allowed by provider
            items:
              type: string
              description: Method of payment required when PaymentType equal BT (applicable only for reservation action).
              enum:
                - CREDIT_CARD
                - INVOICE
                - TRAVEL_ACCOUNT
          discountCodes:
            type: array
            description: list of discount codes
            items:
              $ref: '#/definitions/DiscountCode'
          language:
            description: code of the preferred language to be used in [ISO 639-1 alpha-2](https://en.wikipedia.org/wiki/ISO_639-1) format, e.g. EN
            type: string
            default: EN
          distance:
            $ref: '#/definitions/Distance'
      - type: object
        required:
          - type
          - id
        properties:
          type:
            description: the resource name
            type: string
          id:
            type: string
            description: offer identifier
  TransferOfferPost:
    description: transfer offer
    allOf:
      - $ref: '#/definitions/TransferOffer'
      - type: object
        properties:
          startConnectedSegment:
            $ref: '#/definitions/TravelSegment'
      - type: object
        properties:
          endConnectedSegment:
            $ref: '#/definitions/TravelSegment'
  AddressCommon:
    description: address of the departure location
    properties:
      line:
        description: Address line with street, number, bulding, etc...
        type: string
        minLength: 1
        maxLength: 70
        example: string-value
      zip:
        description: Post office code number
        type: string
        minLength: 1
        maxLength: 120
        example: string-value
      countryCode:
        description: Country code (two character standard IATA country code)
        type: string
        pattern: '[a-zA-Z]{2}'
        example: FR
      cityName:
        description: City, town or postal station
        type: string
        minLength: 1
        maxLength: 35
        example: Paris
      stateCode:
        description: State code (two character standard IATA state code)
        type: string
        pattern: '[a-zA-Z0-9]{1-2}'
        example: string-value
  Address:
    type: object
    description: address information
    properties:
      line:
        description: Address line with street, number, bulding, etc...
        type: string
        minLength: 1
        maxLength: 70
        example: string-value
      zip:
        description: Post office code number
        type: string
        minLength: 1
        maxLength: 120
        example: string-value
      countryCode:
        description: Country code (two character standard IATA country code)
        type: string
        pattern: '[a-zA-Z]{2}'
        example: FR
      cityName:
        description: City, town or postal station
        type: string
        minLength: 1
        maxLength: 35
        example: Paris
      stateCode:
        description: State code (two character standard IATA state code)
        type: string
        pattern: '[a-zA-Z0-9]{1-2}'
        example: string-value
      latitude:
        description: latitude of the location
        type: number
        format: double
        example: 43.580418
      longitude:
        description: longitude of the location
        type: number
        format: double
        example: 7.125102
  Baggage:
    type: object
    properties:
      count:
        type: integer
        description: baggage capacity
        example: 3
      size:
        type: string
        description: "baggage size\n\ncode   | name                                 \n------ | ---------------------------- \nS \t   | Small\nM \t   | Medium\nL \t   | Large\n"
        enum:
          - S
          - M
          - L
        example: S
  CancellationRule:
    type: object
    description: cancellation rule information
    properties:
      ruleDescription:
        type: string
        description: description of cancellation rule
        example: Sample description text.
      feeType:
        type: string
        enum:
          - PERCENTAGE
          - VALUE
        description: |
          type of fee - percentage of total amount (PERCENTAGE) or fixed amount (VALUE)
        example: PERCENTAGE
      feeValue:
        type: string
        description: value of the fee, e.g. "100" or "12.50"
        example: string-value
      currencyCode:
        type: string
        pattern: '[A-Z]{3}'
        description: currency code of the fee in [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format, e.g. USD, EUR
        example: EUR
      metricType:
        type: string
        description: type of metric
        enum:
          - MINUTES
          - HOURS
          - DAYS
          - YEARS
        example: MINUTES
      metricMin:
        type: string
        description: metric min value
        example: string-value
      metricMax:
        type: string
        description: metric max value
        example: string-value
  Contact:
    type: object
    properties:
      phoneNumber:
        type: string
        pattern: ([+]?)[0-9]{1,20}
        description: Contact phone number
        example: '+33123456789'
      email:
        type: string
        format: email
        description: Contact email
        example: [email protected]
  DiscountCode:
    type: object
    description: discount object that gives access to negotiated prices
    properties:
      type:
        type: string
        description: describes type of discount
        enum:
          - CD
          - PC
        example: CD
      value:
        type: string
        description: |-
          discount code value. 
          "CD" type stands for corporate discount code - a number generated by provider in case of
            special agreement with a given subscriber is passed (airlines, TMC,
            corporation…). It gives to subscriber access to negotiated prices for
            transfer      
          "PC" - for promotional/campaign discount code - a voucher code generated by the
            provider valid for a given period of time or a given number of usage.
            The code is sent by customer to provider in order to get a discounted
            price.
        example: string-value
  Distance:
    properties:
      value:
        description: great-circle distance between two locations. This distance thus do not take into account traffic conditions; international boundaries; mountains; water; or other elements that might make the a nearby location hard to reach.
        type: integer
        example: 152
      unit:
        description: unit of the distance
        type: string
        example: KM
        enum:
          - KM
          - MI
  Equipment:
    type: object
    description: extra equipment information
    required:
      - code
    properties:
      code:
        type: string
        description: |
          extra equipment codes, which can take following values

          code   | name                                 
          ------ | -------------------------------------  
          BBS    | Baby stroller/Push chair
          BYC    | Bicycle rack
          CBB    | Cargo barrier rack
          CBF    | Cargo barrier front
          CBS    | Booster seat for child under 135cm or up to 12 years
          CSB    | Child seat determined by weight/age of child 1-3 years / 9-18 Kg
          CSI    | Child seat determined by weight/age of child 0-12 month/0-13Kg
          CST    | Child seat determined by weight/age of child 4-7 years/15 – 30 Kg
          SBR    | Snow board racks
          SKB    | Ski box
          SKR    | Ski rack
          TAB    | Travel Tablet 
          WAR    | Wheelchair access ramp
          WHC    | Wheelchair
          WIF    | Wi-Fi access
          CNT    | Charger cable
        enum:
          - BBS
          - BYC
          - CBB
          - CBF
          - CBS
          - CSB
          - CSI
          - CST
          - SBR
          - SKB
          - SKR
          - 'TAB '
          - WAR
          - WHC
          - WIF
          - CNT
        example: BBS
      itemId:
        type: string
        description: extra equipment identifier
        example: '12345'
      description:
        type: string
        description: extra equipment description
        example: Sample description text.
      quotation:
        $ref: '#/definitions/Quotation'
      converted:
        $ref: '#/definitions/Quotation'
      isBookable:
        type: boolean
        description: true if extra equipment is available for booking
        example: true
      taxIncluded:
        type: boolean
        description: true if tax included in extra equipment price
        example: true
      includedInTotal:
        type: boolean
        description: true if extra equipment price is included in total transfer amount
        example: '199.50'
  ExtraService:
    type: object
    required:
      - code
    properties:
      code:
        type: string
        description: |
          extra service code, which can take following values

          code   | name                                 
          ------ | ---------------------------- 
          DSL    | Driver language specified
          EWT    | Extra waiting time
          MAG    | Meet & Greet
          FLM    | Flight monitoring
          NWS    | Newspaper
          CAI    | Cancellation insurance
          WNR    | Wait and Return. Driver waits at destination and brings back the customer to pick-up point
        enum:
          - DSL
          - EWT
          - MAG
          - FLM
          - NWS
          - CAI
          - WNR
        example: DSL
      itemId:
        type: string
        description: extra service identifier
        example: '12345'
      description:
        type: string
        description: extra service description
        example: Sample description text.
      metricType:
        type: string
        description: extra service time metric type
        enum:
          - YEARS
          - DAYS
          - HOURS
          - MINUTES
        example: YEARS
      metricValue:
        type: string
        description: extra service metric value
        example: string-value
      quotation:
        $ref: '#/definitions/Quotation'
      converted:
        $ref: '#/definitions/Quotation'
      isBookable:
        type: boolean
        description: true if extra service is available for booking
        example: true
      taxIncluded:
        type: boolean
        description: true if tax included in extra service price
        example: true
      includedInTotal:
        type: boolean
        description: true if extra service price is included in total transfer amount
        example: '199.50'
  Fee:
    description: single fee information
    allOf:
      - $ref: '#/definitions/PointsAndCash'
      - type: object
        properties:
          currencyCode:
            type: string
            example: USD
          indicator:
            type: string
            description: fee category e.g. "AIRPORT", "CREDITCARD" ,"CANCELLATION"
  Location:
    type: object
    description: location information
    properties:
      dateTime:
        description: |
          date and time specified in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) YYYY-MM-DDThh:mm:ss format e.g. 2017-11-10T10:00:00
          not supported for stopOvers object
        type: string
        example: '2019-11-10T10:30:00'
      locationCode:
        type: string
        description: airport code from [IATA table codes](http://www.iata.org/publications/Pages/code-search.aspx), e.g. CDG.
        pattern: '[A-Za-z]{3}'
        example: CDG
      address:
        $ref: '#/definitions/Address'
      name:
        type: string
        description: Place name e.g. Airport Name, Hotel Name etc.
        example: Sample Name
      googlePlaceId:
        description: Google place id only for google address e.g. ChIJL-DOWeBv5kcRfTbh97PimNc.
        type: string
        example: ChIJrTLr-GyuEmsRBfy61i59si0
      uicCode:
        type: string
        description: UIC code defined by the worldwide railway organization e.g. 8600626
        example: string-value
  StopOver:
    description: Location of the stop over or the several stop over points. It can be defined either using IATA code or Address (address line, zip, country, city, state, latitude, longitude). Vehicle change via stop overs is not supported.
    properties:
      duration:
        description: transfer stop duration in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) PnYnMnDTnHnMnS format, e.g. PT2H10M.
        type: string
        example: PT2H30M
      sequenceNumber:
        description: sequence number of the stop e.g. 3
        type: number
        example: 1
      location:
        $ref: '#/definitions/Location'
  StopOverRequest:
    properties:
      duration:
        description: the intermediate stop duration in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) PnYnMnDTnHnMnS format, e.g. PT2H10M
        type: string
        example: PT2H30M
      locationCode:
        type: string
        description: the intermediate stop airport IATA code, e.g. CDG. Location could be defined either using location code or address (address line, zip code, country code, city, geo code)
        pattern: '[A-Za-z]{3}'
        example: CDG
      addressLine:
        type: string
        description: the intermediate stop street address including building number, e.g. 5 Avenue Anatole France
        example: 5 Avenue Anatole France
      countryCode:
        type: string
        description: the intermediate stop country, the location with [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format (e.g. US)
        pattern: '[A-Za-z]{2}'
        example: US
      cityName:
        type: string
        description: the intermediate stop city name, e.g. Paris
        example: Paris
      zipCode:
        type: string
        description: the intermediate stop postal/zip code, e.g. 75007
        pattern: '[a-zA-Z0-9]{1,20}'
        example: 75007
      googlePlaceId:
        description: the intermediate stop google place id only for google address e.g. ChIJL-DOWeBv5kcRfTbh97PimNc.
        type: string
        example: ChIJrTLr-GyuEmsRBfy61i59si0
      name:
        type: string
        description: the intermediate stop name e.g. Airport Name, Hotel Name etc.
        example: Sample Name
      stateCode:
        type: string
        description: the intermediate stop state code according to [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)
        example: string-value
      geoCode:
        type: string
        description: the intermediate stop latitude and longitude of geographical location following the structure {latitude},{longitude} e.g. 48.858093,2.294694
        example: 48.858093,2.294694
      sequenceNumber:
        description: sequence number of the stop e.g. 3
        type: number
        example: 1
      uicCode:
        type: string
        description: UIC code defined by the worldwide railway organization e.g. 8600626
        example: string-value
  PassengerCharacteristics:
    properties:
      passengerTypeCode:
        description: Passenger type codes e.g. CHD , ADT. CHD is for child and ADT for Adult.
        type: string
        example: child
      age:
        type: integer
        description: Age of the Passenger (Mandatory if typeCode= “CHD”)
        example: 12
  PartnerInfo:
    type: object
    description: Information about partner/subprovider. Below settings configuration is not applicable for sub-provider. Fields 'code', 'name' and 'logoUrl' are not mandatory for sub-provider.
    properties:
      serviceProvider:
        $ref: '#/defi

# --- truncated at 32 KB (48 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/openapi/amadeus-transfer-search-openapi.yml