{
  "openapi": "3.1.0",
  "info": {
    "title": "Partners API",
    "description": "This API is used to rapidly develop API integrations with partners.",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://warpdrive.staging.transferz.com/partners",
      "description": "Transferz staging"
    }
  ],
  "tags": [
    {
      "name": "Quotes",
      "description": "This API offers functionalities to retrieve quotes for provided travel details."
    },
    {
      "name": "Bookings",
      "description": "This API offers functionalities to create and retrieve bookings and journeys."
    },
    {
      "name": "Flights",
      "description": "This API offers functionalities to search for flight details."
    },
    {
      "name": "Journeys",
      "description": "This API offers functionalities to retrieve and update journeys."
    }
  ],
  "paths": {
    "/quotes": {
      "post": {
        "tags": [
          "Quotes"
        ],
        "summary": "Request quotes",
        "description": "Retrieves a set of quotes for the provided input parameters",
        "operationId": "getQuotes",
        "parameters": [
          {
            "name": "X-Request-ID",
            "in": "header",
            "description": "The optional (ideally unique) request identifier used for later analysis or diagnostics",
            "required": false,
            "schema": {}
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/QuoteRequestDto"
              },
              "example": {
                "origin": {
                  "iataCode": "AMS"
                },
                "destination": {
                  "address": {
                    "addressSearchPhrase": "Herengracht 182, Amsterdam",
                    "countryCode": "NL"
                  }
                },
                "pickupDateTime": "2026-12-01T14:30:00",
                "adultPassengers": 2,
                "childPassengers": 0,
                "infantPassengers": 0,
                "checkedLuggage": 2,
                "carryOnLuggage": 1,
                "currencyCode": "EUR"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QuoteResponseDto"
                },
                "example": {
                  "id": 905512,
                  "origin": {
                    "bookerEnteredAddress": "AMS",
                    "resolvedAddress": "Amsterdam Airport Schiphol (AMS), Evert van de Beekstraat 202, 1118 CP Schiphol, Netherlands",
                    "fullResolvedAddress": {
                      "streetName": "Evert van de Beekstraat",
                      "streetNumber": "202",
                      "city": "Schiphol",
                      "postalCode": "1118 CP",
                      "region": "Noord-Holland",
                      "countryCode": "NL",
                      "establishment": "Amsterdam Airport Schiphol"
                    },
                    "latitude": 52.3105,
                    "longitude": 4.7683,
                    "hub": true,
                    "iataCode": "AMS",
                    "usedResolutionMethod": "IATA_CODE"
                  },
                  "destination": {
                    "bookerEnteredAddress": "Herengracht 182, Amsterdam",
                    "resolvedAddress": "Herengracht 182, 1016 BR Amsterdam, Netherlands",
                    "fullResolvedAddress": {
                      "streetName": "Herengracht",
                      "streetNumber": "182",
                      "city": "Amsterdam",
                      "postalCode": "1016 BR",
                      "region": "Noord-Holland",
                      "countryCode": "NL",
                      "establishment": "Hotel Example Canal House"
                    },
                    "latitude": 52.3738,
                    "longitude": 4.8862,
                    "hub": false,
                    "iataCode": null,
                    "usedResolutionMethod": "ADDRESS_PHRASE"
                  },
                  "quotes": [
                    {
                      "id": 7731201,
                      "vehicleCategory": "SEDAN",
                      "vehicleImageUrl": "https://cdn.example.com/vehicles/sedan.png",
                      "vehicleModels": "Toyota Corolla Touring or similar",
                      "passengerCapacity": 3,
                      "luggageCapacity": 3,
                      "price": 57,
                      "vat": 4.71,
                      "commission": 5.7,
                      "commissionVat": 0,
                      "discount": 0,
                      "discountPercentage": 0,
                      "discountVat": 0,
                      "currencyCode": "EUR",
                      "combinedSeatBasedAddonCapacity": 2,
                      "expires": "2026-11-20T10:45:00",
                      "availableTravelAddons": [
                        {
                          "id": 77312011,
                          "type": "MEET_GREET",
                          "price": 15,
                          "commission": 1.5,
                          "maxAllowed": 1
                        },
                        {
                          "id": 77312012,
                          "type": "CHILD_SEAT",
                          "price": 10,
                          "commission": 1,
                          "maxAllowed": 2
                        }
                      ],
                      "includedWaitingTimeInMinutes": 60,
                      "freeCancellationUntil": "2026-11-30T14:30:00",
                      "instantConfirmation": true,
                      "pricePerPassenger": false
                    },
                    {
                      "id": 7731202,
                      "vehicleCategory": "MINIVAN",
                      "vehicleImageUrl": "https://cdn.example.com/vehicles/minivan.png",
                      "vehicleModels": "Mercedes-Benz V-Class or similar",
                      "passengerCapacity": 7,
                      "luggageCapacity": 7,
                      "price": 79,
                      "vat": 6.52,
                      "commission": 7.9,
                      "commissionVat": 0,
                      "discount": 0,
                      "discountPercentage": 0,
                      "discountVat": 0,
                      "currencyCode": "EUR",
                      "combinedSeatBasedAddonCapacity": 2,
                      "expires": "2026-11-20T10:45:00",
                      "availableTravelAddons": [
                        {
                          "id": 77312021,
                          "type": "MEET_GREET",
                          "price": 15,
                          "commission": 1.5,
                          "maxAllowed": 1
                        },
                        {
                          "id": 77312022,
                          "type": "CHILD_SEAT",
                          "price": 10,
                          "commission": 1,
                          "maxAllowed": 2
                        }
                      ],
                      "includedWaitingTimeInMinutes": 60,
                      "freeCancellationUntil": "2026-11-30T14:30:00",
                      "instantConfirmation": true,
                      "pricePerPassenger": false
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    },
    "/quotes/suggest-pickup-time": {
      "post": {
        "tags": [
          "Quotes"
        ],
        "summary": "Suggest pickup time",
        "description": "Suggests a pickup time based on flight arrival or departure to be used in a subsequent quote request",
        "operationId": "getSuggestedPickupTime",
        "parameters": [
          {
            "name": "X-Request-ID",
            "in": "header",
            "description": "The optional (ideally unique) request identifier used for later analysis or diagnostics",
            "required": false,
            "schema": {}
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SuggestedPickupTimeRequestDto"
              },
              "example": {
                "origin": {
                  "address": {
                    "addressSearchPhrase": "Herengracht 182, Amsterdam",
                    "countryCode": "NL"
                  }
                },
                "destination": {
                  "iataCode": "AMS"
                },
                "departureOrArrivalTime": "2026-12-08T11:05:00",
                "travelType": "INTERNATIONAL",
                "onlyCarryOnLuggage": false,
                "roundToNearestMinutes": 15,
                "flightNumber": "TZ1235"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SuggestedPickupTimeResponseDto"
                },
                "example": {
                  "directionality": "DEPARTURE",
                  "suggestedPickupTime": "2026-12-08T07:30:00",
                  "distanceInMeters": 19800,
                  "durationInMinutes": 26,
                  "bufferTime": 180
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    },
    "/journeys/{journeyId}/changes": {
      "post": {
        "tags": [
          "Journeys"
        ],
        "summary": "Create journey change",
        "description": "Creates a change to an existing journey and applies it if no additional payment is required",
        "operationId": "createJourneyChange",
        "parameters": [
          {
            "name": "journeyId",
            "in": "path",
            "description": "The id of the journey to change",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "X-Request-ID",
            "in": "header",
            "description": "The optional (ideally unique) request identifier used for later analysis or diagnostics",
            "required": false,
            "schema": {}
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/JourneyChangeRequestDto"
              },
              "example": {
                "pickupDate": "2026-12-01T15:15:00",
                "travellerInfo": {
                  "firstName": "Alex",
                  "lastName": "Traveller",
                  "email": "alex.traveller@example.com",
                  "phone": "+447700900123",
                  "meetAndGreetSignText": "Alex Traveller",
                  "driverComments": "Two suitcases and a stroller.",
                  "flightNumber": "TZ1234",
                  "trainNumber": null,
                  "shipName": null,
                  "languageIsoCode": "en",
                  "residenceCountryCode": "GB",
                  "passengers": {
                    "adultPassengers": 3,
                    "childPassengers": 0,
                    "infantPassengers": 0
                  },
                  "luggage": {
                    "checkedLuggage": 3,
                    "carryOnLuggage": 1
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JourneyChangeResponseDto"
                },
                "example": {
                  "changeId": 20417,
                  "additionalPaymentRequired": true,
                  "previousPrice": {
                    "commission": 7.2,
                    "commissionVat": 0,
                    "price": 72,
                    "priceVat": 5.94,
                    "currency": "EUR",
                    "discountCode": null,
                    "discountAmount": 0,
                    "discountPercentage": 0,
                    "discountVat": 0
                  },
                  "newPrice": {
                    "commission": 9.4,
                    "commissionVat": 0,
                    "price": 94,
                    "priceVat": 7.76,
                    "currency": "EUR",
                    "discountCode": null,
                    "discountAmount": 0,
                    "discountPercentage": 0,
                    "discountVat": 0
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    },
    "/journeys/{journeyId}/changes/{changeId}/pay-by-invoice": {
      "post": {
        "tags": [
          "Journeys"
        ],
        "summary": "Pay journey change on invoice",
        "description": "Pays for the provided journey change on invoice, after which it will be applied",
        "operationId": "payForJourneyChangeOnInvoice",
        "parameters": [
          {
            "name": "journeyId",
            "in": "path",
            "description": "The id of the journey to change",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "changeId",
            "in": "path",
            "description": "The id of the change to confirm",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "X-Request-ID",
            "in": "header",
            "description": "The optional (ideally unique) request identifier used for later analysis or diagnostics",
            "required": false,
            "schema": {}
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JourneyDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    },
    "/journeys/{journeyId}/changes/{changeId}/generate-payment-link": {
      "post": {
        "tags": [
          "Journeys"
        ],
        "summary": "Generate journey change payment link",
        "description": "Generates a payment link to perform the additional payment for the journey change",
        "operationId": "generatePaymentLinkForJourneyChange",
        "parameters": [
          {
            "name": "journeyId",
            "in": "path",
            "description": "The id of the journey to change",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "changeId",
            "in": "path",
            "description": "The id of the change to confirm",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "X-Request-ID",
            "in": "header",
            "description": "The optional (ideally unique) request identifier used for later analysis or diagnostics",
            "required": false,
            "schema": {}
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentLinkDto"
                },
                "example": {
                  "url": "https://test.adyen.link/PLTZ7K4QM0002",
                  "expiresAt": "2026-11-28T16:20:00"
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    },
    "/journeys/{journeyId}/cancel": {
      "post": {
        "tags": [
          "Journeys"
        ],
        "summary": "Cancel journey",
        "description": "Cancels a previously created journey",
        "operationId": "cancelJourney",
        "parameters": [
          {
            "name": "journeyId",
            "in": "path",
            "description": "The id of the journey to cancel",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "X-Request-ID",
            "in": "header",
            "description": "The optional (ideally unique) request identifier used for later analysis or diagnostics",
            "required": false,
            "schema": {}
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CancelJourneyDto"
              },
              "example": {
                "reason": "NOT_NEEDED_ANYMORE",
                "acceptCharges": true
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JourneyDto"
                },
                "example": {
                  "id": 488213,
                  "code": "TZ7K4QM-1",
                  "quoteId": 7731201,
                  "vehicleCategory": "SEDAN",
                  "pickupTimeAdjustmentMethod": "FLIGHT_TRACKING",
                  "origin": {
                    "bookerEnteredAddress": "AMS",
                    "resolvedAddress": "Amsterdam Airport Schiphol (AMS), Evert van de Beekstraat 202, 1118 CP Schiphol, Netherlands",
                    "fullResolvedAddress": {
                      "streetName": "Evert van de Beekstraat",
                      "streetNumber": "202",
                      "city": "Schiphol",
                      "postalCode": "1118 CP",
                      "region": "Noord-Holland",
                      "countryCode": "NL",
                      "establishment": "Amsterdam Airport Schiphol"
                    },
                    "latitude": 52.3105,
                    "longitude": 4.7683,
                    "hub": true,
                    "iataCode": "AMS",
                    "usedResolutionMethod": "IATA_CODE"
                  },
                  "destination": {
                    "bookerEnteredAddress": "Herengracht 182, Amsterdam",
                    "resolvedAddress": "Herengracht 182, 1016 BR Amsterdam, Netherlands",
                    "fullResolvedAddress": {
                      "streetName": "Herengracht",
                      "streetNumber": "182",
                      "city": "Amsterdam",
                      "postalCode": "1016 BR",
                      "region": "Noord-Holland",
                      "countryCode": "NL",
                      "establishment": "Hotel Example Canal House"
                    },
                    "latitude": 52.3738,
                    "longitude": 4.8862,
                    "hub": false,
                    "iataCode": null,
                    "usedResolutionMethod": "ADDRESS_PHRASE"
                  },
                  "pickup": {
                    "localTime": "2026-12-01T14:30:00",
                    "timeZone": "Europe/Amsterdam"
                  },
                  "transferCompany": {
                    "id": 2290,
                    "name": "Canal City Transfers",
                    "phoneNumber": "+442079460150"
                  },
                  "driver": null,
                  "meetingPoint": {
                    "id": 2561,
                    "type": "HUB",
                    "name": "Schiphol Plaza meeting point",
                    "description": "Walk to the Meeting Point sign in Schiphol Plaza, opposite arrivals 3. Your driver waits there with a name sign.",
                    "lat": 52.3094,
                    "lng": 4.7622,
                    "files": [
                      {
                        "id": 99102,
                        "fileType": "MAP",
                        "url": "https://cdn.example.com/meeting-points/2561/map.png"
                      }
                    ]
                  },
                  "approxDurationAndDistance": {
                    "distance": 19.8,
                    "distanceUnit": "KILOMETER",
                    "durationInSeconds": 1560
                  },
                  "traveller": {
                    "firstName": "Alex",
                    "lastName": "Traveller",
                    "email": "alex.traveller@example.com",
                    "phone": "+447700900123",
                    "meetAndGreetSignText": "Alex Traveller",
                    "driverComments": "Two suitcases and a stroller.",
                    "flightNumber": "TZ1234",
                    "trainNumber": null,
                    "shipName": null,
                    "languageIsoCode": "en",
                    "residenceCountryCode": "GB"
                  },
                  "travelAddons": [
                    {
                      "type": "MEET_GREET",
                      "amount": 1
                    }
                  ],
                  "status": "CANCELLED_WITH_COSTS",
                  "cancellationDetails": {
                    "cancellable": false,
                    "freeCancellationUntil": "2026-11-30T14:30:00",
                    "freeCancellationWindowHours": 24
                  },
                  "priceSummary": {
                    "commission": 7.2,
                    "commissionVat": 0,
                    "price": 72,
                    "priceVat": 5.94,
                    "currency": "EUR",
                    "discountCode": null,
                    "discountAmount": 0,
                    "discountPercentage": 0,
                    "discountVat": 0
                  },
                  "customerServiceInfo": {
                    "supportPhoneNumber": "+442079460100"
                  },
                  "travellerAppUrl": "https://traveller.example.com/j/TZ7K4QM-1"
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    },
    "/bookings": {
      "post": {
        "tags": [
          "Bookings"
        ],
        "summary": "Create booking",
        "description": "Creates a booking using one or more provided quotes",
        "operationId": "createBooking",
        "parameters": [
          {
            "name": "X-Request-ID",
            "in": "header",
            "description": "The optional (ideally unique) request identifier used for later analysis or diagnostics",
            "required": false,
            "schema": {}
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateBookingDto"
              },
              "example": {
                "booker": {
                  "firstName": "Alex",
                  "lastName": "Traveller",
                  "email": "alex.traveller@example.com",
                  "phone": "+447700900123",
                  "companyName": null,
                  "reference": "ORDER-10023",
                  "languageIsoCode": "en"
                },
                "quotes": [
                  {
                    "quoteId": 7731201,
                    "traveller": {
                      "firstName": "Alex",
                      "lastName": "Traveller",
                      "email": "alex.traveller@example.com",
                      "phone": "+447700900123",
                      "meetAndGreetSignText": "Alex Traveller",
                      "driverComments": "Two suitcases and a stroller.",
                      "flightNumber": "TZ1234",
                      "trainNumber": null,
                      "shipName": null,
                      "languageIsoCode": "en",
                      "residenceCountryCode": "GB"
                    },
                    "travelAddons": [
                      {
                        "quoteTravelAddonId": 77312011,
                        "amount": 1
                      }
                    ]
                  }
                ],
                "partnerReference": "ORDER-10023",
                "travelIntent": "LEISURE"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BookingDto"
                },
                "example": {
                  "id": 312840,
                  "code": "TZ7K4QM",
                  "partnerReference": "ORDER-10023",
                  "partnerId": 4100,
                  "travelIntent": "LEISURE",
                  "bookerInfo": {
                    "firstName": "Alex",
                    "lastName": "Traveller",
                    "email": "alex.traveller@example.com",
                    "phone": "+447700900123",
                    "companyName": null,
                    "reference": "ORDER-10023",
                    "languageIsoCode": "en"
                  },
                  "journeys": [
                    {
                      "id": 488213,
                      "code": "TZ7K4QM-1",
                      "quoteId": 7731201,
                      "vehicleCategory": "SEDAN",
                      "pickupTimeAdjustmentMethod": "FLIGHT_TRACKING",
                      "origin": {
                        "bookerEnteredAddress": "AMS",
                        "resolvedAddress": "Amsterdam Airport Schiphol (AMS), Evert van de Beekstraat 202, 1118 CP Schiphol, Netherlands",
                        "fullResolvedAddress": {
                          "streetName": "Evert van de Beekstraat",
                          "streetNumber": "202",
                          "city": "Schiphol",
                          "postalCode": "1118 CP",
                          "region": "Noord-Holland",
                          "countryCode": "NL",
                          "establishment": "Amsterdam Airport Schiphol"
                        },
                        "latitude": 52.3105,
                        "longitude": 4.7683,
                        "hub": true,
                        "iataCode": "AMS",
                        "usedResolutionMethod": "IATA_CODE"
                      },
                      "destination": {
                        "bookerEnteredAddress": "Herengracht 182, Amsterdam",
                        "resolvedAddress": "Herengracht 182, 1016 BR Amsterdam, Netherlands",
                        "fullResolvedAddress": {
                          "streetName": "Herengracht",
                          "streetNumber": "182",
                          "city": "Amsterdam",
                          "postalCode": "1016 BR",
                          "region": "Noord-Holland",
                          "countryCode": "NL",
                          "establishment": "Hotel Example Canal House"
                        },
                        "latitude": 52.3738,
                        "longitude": 4.8862,
                        "hub": false,
                        "iataCode": null,
                        "usedResolutionMethod": "ADDRESS_PHRASE"
                      },
                      "pickup": {
                        "localTime": "2026-12-01T14:30:00",
                        "timeZone": "Europe/Amsterdam"
                      },
                      "transferCompany": null,
                      "driver": null,
                      "meetingPoint": null,
                      "approxDurationAndDistance": {
                        "distance": 19.8,
                        "distanceUnit": "KILOMETER",
                        "durationInSeconds": 1560
                      },
                      "traveller": {
                        "firstName": "Alex",
                        "lastName": "Traveller",
                        "email": "alex.traveller@example.com",
                        "phone": "+447700900123",
                        "meetAndGreetSignText": "Alex Traveller",
                        "driverComments": "Two suitcases and a stroller.",
                        "flightNumber": "TZ1234",
                        "trainNumber": null,
                        "shipName": null,
                        "languageIsoCode": "en",
                        "residenceCountryCode": "GB"
                      },
                      "travelAddons": [
                        {
                          "type": "MEET_GREET",
                          "amount": 1
                        }
                      ],
                      "status": "NOT_PAID",
                      "cancellationDetails": {
                        "cancellable": true,
                        "freeCancellationUntil": "2026-11-30T14:30:00",
                        "freeCancellationWindowHours": 24
                      },
                      "priceSummary": {
                        "commission": 7.2,
                        "commissionVat": 0,
                        "price": 72,
                        "priceVat": 5.94,
                        "currency": "EUR",
                        "discountCode": null,
                        "discountAmount": 0,
                        "discountPercentage": 0,
                        "discountVat": 0
                      },
                      "customerServiceInfo": {
                        "supportPhoneNumber": "+442079460100"
                      },
                      "travellerAppUrl": "https://traveller.example.com/j/TZ7K4QM-1"
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    },
    "/bookings/{id}/pay-by-stripe-connect": {
      "post": {
        "tags": [
          "Bookings"
        ],
        "summary": "Pay by Stripe Connect",
        "description": "Pays for a booking using a Stripe Connect payment intent",
        "operationId": "payByStripeConnect",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "The id of the booking for which to pay through Stripe Connect",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "X-Request-ID",
            "in": "header",
            "description": "The optional (ideally unique) request identifier used for later analysis or diagnostics",
            "required": false,
            "schema": {}
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PayByStripeConnectDto"
              },
              "example": {
                "paymentIntent": "pi_3TzExample0000000001"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BookingDto"
                },
                "example": {
                  "id": 312840,
                  "code": "TZ7K4QM",
                  "partnerReference": "ORDER-10023",
                  "partnerId": 4100,
                  "travelIntent": "LEISURE",
                  "bookerInfo": {
                    "firstName": "Alex",
                    "lastName": "Traveller",
                    "email": "alex.traveller@example.com",
                    "phone": "+447700900123",
                    "companyName": null,
                    "reference": "ORDER-10023",
                    "languageIsoCode": "en"
                  },
                  "journeys": [
                    {
                      "id": 488213,
                      "code": "TZ7K4QM-1",
                      "quoteId": 7731201,
                      "vehicleCategory": "SEDAN",
                      "pickupTimeAdjustmentMethod": "FLIGHT_TRACKING",
                      "origin": {
                        "bookerEnteredAddress": "AMS",
                        "resolvedAddress": "Amsterdam Airport Schiphol (AMS), Evert van de Beekstraat 202, 1118 CP Schiphol, Netherlands",
                        "fullResolvedAddress": {
                          "streetName": "Evert van de Beekstraat",
                          "streetNumber": "202",
                          "city": "Schiphol",
                          "postalCode": "1118 CP",
                          "region": "Noord-Holland",
                          "countryCode": "NL",
                          "establishment": "Amsterdam Airport Schiphol"
                        },
                        "latitude": 52.3105,
                        "longitude": 4.7683,
                        "hub": true,
                        "iataCode": "AMS",
                        "usedResolutionMethod": "IATA_CODE"
                      },
                      "destination": {
                        "bookerEnteredAddress": "Herengracht 182, Amsterdam",
                        "resolvedAddress": "Herengracht 182, 1016 BR Amsterdam, Netherlands",
                        "fullResolvedAddress": {
                          "streetName": "Herengracht",
                          "streetNumber": "182",
                          "city": "Amsterdam",
                          "postalCode": "1016 BR",
                          "region": "Noord-Holland",
                          "countryCode": "NL",
                          "establishment": "Hotel Example Canal House"
                        },
                        "latitude": 52.3738,
                        "longitude": 4.8862,
                        "hub": false,
                        "iataCode": null,
                        "usedResolutionMethod": "ADDRESS_PHRASE"
                      },
                      "pickup": {
                        "localTime": "2026-12-01T14:30:00",
                        "timeZone": "Europe/Amsterdam"
                      },
                      "transferCompany": null,
                      "driver": null,
                      "meetingPoint": null,
                      "approxDurationAndDistance": {
                        "distance": 19.8,
                        "distanceUnit": "KILOMETER",
                        "durationInSeconds": 1560
                      },
                      "traveller": {
                        "firstName": "Alex",
                        "lastName": "Traveller",
                        "email": "alex.traveller@example.com",
                        "phone": "+447700900123",
                        "meetAndGreetSignText": "Alex Traveller",
                        "driverComments": "Two suitcases and a stroller.",
                        "flightNumber": "TZ1234",
                        "trainNumber": null,
                        "shipName": null,
                        "languageIsoCode": "en",
                        "residenceCountryCode": "GB"
                      },
                      "travelAddons": [
                        {
                          "type": "MEET_GREET",
                          "amount": 1
                        }
                      ],
                      "status": "PENDING",
                      "cancellationDetails": {
                        "cancellable": true,
                        "freeCancellationUntil": "2026-11-30T14:30:00",
                        "freeCancellationWindowHours": 24
                      },
                      "priceSummary": {
                        "commission": 7.2,
                        "commissionVat": 0,
                        "price": 72,
                        "priceVat": 5.94,
                        "currency": "EUR",
                        "discountCode": null,
                        "discountAmount": 0,
                        "discountPercentage": 0,
                        "discountVat": 0
                      },
                      "customerServiceInfo": {
                        "supportPhoneNumber": "+442079460100"
                      },
                      "travellerAppUrl": "https://traveller.example.com/j/TZ7K4QM-1"
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    },
    "/bookings/{id}/pay-by-invoice": {
      "post": {
        "tags": [
          "Bookings"
        ],
        "summary": "Pay by invoice",
        "description": "Pays for a booking on invoice (only supported for selected partners)",
        "operationId": "payByInvoice",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "The id of the booking for which to pay on invoice",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "X-Request-ID",
            "in": "header",
            "description": "The optional (ideally unique) request identifier used for later analysis or diagnostics",
            "required": false,
            "schema": {}
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BookingDto"
                },
                "example": {
                  "id": 312840,
                  "code": "TZ7K4QM",
                  "partnerReference": "ORDER-10023",
                  "partnerId": 4100,
                  "travelIntent": "LEISURE",
                  "bookerInfo": {
                    "firstName": "Alex",
                    "lastName": "Traveller",
                    "email": "alex.traveller@example.com",
                    "phone": "+447700900123",
                    "companyName": null,
                    "reference": "ORDER-10023",
                    "languageIsoCode": "en"
                  },
                  "journeys": [
                    {
                      "id": 488213,
                      "code": "TZ7K4QM-1",
                      "quoteId": 7731201,
                      "vehicleCategory": "SEDAN",
                      "pickupTimeAdjustmentMethod": "FLIGHT_TRACKING",
                      "origin": {
                        "bookerEnteredAddress": "AMS",
                        "resolvedAddress": "Amsterdam Airport Schiphol (AMS), Evert van de Beekstraat 202, 1118 CP Schiphol, Netherlands",
                        "fullResolvedAddress": {
                          "streetName": "Evert van de Beekstraat",
                          "streetNumber": "202",
                          "city": "Schiphol",
                          "postalCode": "1118 CP",
                          "region": "Noord-Holland",
                          "countryCode": "NL",
                          "establishment": "Amsterdam Airport Schiphol"
                        },
                        "latitude": 52.3105,
                        "longitude": 4.7683,
                        "hub": true,
                        "iataCode": "AMS",
                        "usedResolutionMethod": "IATA_CODE"
                      },
                      "destination": {
                        "bookerEnteredAddress": "Herengracht 182, Amsterdam",
                        "resolvedAddress": "Herengracht 182, 1016 BR Amsterdam, Netherlands",
                        "fullResolvedAddress": {
                          "streetName": "Herengracht",
                          "streetNumber": "182",
                          "city": "Amsterdam",
                          "postalCode": "1016 BR",
                          "region": "Noord-Holland",
                          "countryCode": "NL",
                          "establishment": "Hotel Example Canal House"
                        },
                        "latitude": 52.3738,
                        "longitude": 4.8862,
                        "hub": false,
                        "iataCode": null,
                        "usedResolutionMethod": "ADDRESS_PHRASE"
                      },
                      "pickup": {
                        "localTime": "2026-12-01T14:30:00",
                        "timeZone": "Europe/Amsterdam"
                      },
                      "transferCompany": null,
                      "driver": null,
                      "meetingPoint": null,
                      "approxDurationAndDistance": {
                        "distance": 19.8,
                        "distanceUnit": "KILOMETER",
                        "durationInSeconds": 1560
                      },
                      "traveller": {
                        "firstName": "Alex",
                        "lastName": "Traveller",
                        "email": "alex.traveller@example.com",
                        "phone": "+447700900123",
                        "meetAndGreetSignText": "Alex Traveller",
                        "driverComments": "Two suitcases and a stroller.",
                        "flightNumber": "TZ1234",
                        "trainNumber": null,
                        "shipName": null,
                        "languageIsoCode": "en",
                        "residenceCountryCode": "GB"
                      },
                      "travelAddons": [
                        {
                          "type": "MEET_GREET",
                          "amount": 1
                        }
                      ],
                      "status": "PENDING",
                      "cancellationDetails": {
                        "cancellable": true,
                        "freeCancellationUntil": "2026-11-30T14:30:00",
                        "freeCancellationWindowHours": 24
                      },
                      "priceSummary": {
                        "commission": 7.2,
                        "commissionVat": 0,
                        "price": 72,
                        "priceVat": 5.94,
                        "currency": "EUR",
                        "discountCode": null,
                        "discountAmount": 0,
                        "discountPercentage": 0,
                        "discountVat": 0
                      },
                      "customerServiceInfo": {
                        "supportPhoneNumber": "+442079460100"
                      },
                      "travellerAppUrl": "https://traveller.example.com/j/TZ7K4QM-1"
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    },
    "/bookings/{id}/generate-payment-link": {
      "post": {
        "tags": [
          "Bookings"
        ],
        "summary": "Generate payment link",
        "description": "Generates a payment link for a previously generated booking",
        "operationId": "generatePaymentLink",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "The id of the booking for which to generate a payment link",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "X-Request-ID",
            "in": "header",
            "description": "The optional (ideally unique) request identifier used for later analysis or diagnostics",
            "required": false,
            "schema": {}
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RequestPaymentLinkDto"
              },
              "example": {
                "locale": "nl",
                "returnUrl": "https://shop.example.com/orders/ORDER-10023/paid"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentLinkDto"
                },
                "example": {
                  "url": "https://test.adyen.link/PLTZ7K4QM0001",
                  "expiresAt": "2026-11-21T10:50:00"
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    },
    "/bookings/{id}/cancel": {
      "post": {
        "tags": [
          "Bookings"
        ],
        "summary": "Cancel booking",
        "description": "Cancels the journeys in a previously created booking",
        "operationId": "cancelBooking",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "The id of the booking to cancel",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "X-Request-ID",
            "in": "header",
            "description": "The optional (ideally unique) request identifier used for later analysis or diagnostics",
            "required": false,
            "schema": {}
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CancelBookingDto"
              },
              "example": {
                "reason": "NOT_NEEDED_ANYMORE",
                "acceptCharges": false
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BookingDto"
                },
                "example": {
                  "id": 312840,
                  "code": "TZ7K4QM",
                  "partnerReference": "ORDER-10023",
                  "partnerId": 4100,
                  "travelIntent": "LEISURE",
                  "bookerInfo": {
                    "firstName": "Alex",
                    "lastName": "Traveller",
                    "email": "alex.traveller@example.com",
                    "phone": "+447700900123",
                    "companyName": null,
                    "reference": "ORDER-10023",
                    "languageIsoCode": "en"
                  },
                  "journeys": [
                    {
                      "id": 488213,
                      "code": "TZ7K4QM-1",
                      "quoteId": 7731201,
                      "vehicleCategory": "SEDAN",
                      "pickupTimeAdjustmentMethod": "FLIGHT_TRACKING",
                      "origin": {
                        "bookerEnteredAddress": "AMS",
                        "resolvedAddress": "Amsterdam Airport Schiphol (AMS), Evert van de Beekstraat 202, 1118 CP Schiphol, Netherlands",
                        "fullResolvedAddress": {
                          "streetName": "Evert van de Beekstraat",
                          "streetNumber": "202",
                          "city": "Schiphol",
                          "postalCode": "1118 CP",
                          "region": "Noord-Holland",
                          "countryCode": "NL",
                          "establishment": "Amsterdam Airport Schiphol"
                        },
                        "latitude": 52.3105,
                        "longitude": 4.7683,
                        "hub": true,
                        "iataCode": "AMS",
                        "usedResolutionMethod": "IATA_CODE"
                      },
                      "destination": {
                        "bookerEnteredAddress": "Herengracht 182, Amsterdam",
                        "resolvedAddress": "Herengracht 182, 1016 BR Amsterdam, Netherlands",
                        "fullResolvedAddress": {
                          "streetName": "Herengracht",
                          "streetNumber": "182",
                          "city": "Amsterdam",
                          "postalCode": "1016 BR",
                          "region": "Noord-Holland",
                          "countryCode": "NL",
                          "establishment": "Hotel Example Canal House"
                        },
                        "latitude": 52.3738,
                        "longitude": 4.8862,
                        "hub": false,
                        "iataCode": null,
                        "usedResolutionMethod": "ADDRESS_PHRASE"
                      },
                      "pickup": {
                        "localTime": "2026-12-01T14:30:00",
                        "timeZone": "Europe/Amsterdam"
                      },
                      "transferCompany": {
                        "id": 2290,
                        "name": "Canal City Transfers",
                        "phoneNumber": "+442079460150"
                      },
                      "driver": null,
                      "meetingPoint": {
                        "id": 2561,
                        "type": "HUB",
                        "name": "Schiphol Plaza meeting point",
                        "description": "Walk to the Meeting Point sign in Schiphol Plaza, opposite arrivals 3. Your driver waits there with a name sign.",
                        "lat": 52.3094,
                        "lng": 4.7622,
                        "files": [
                          {
                            "id": 99102,
                            "fileType": "MAP",
                            "url": "https://cdn.example.com/meeting-points/2561/map.png"
                          }
                        ]
                      },
                      "approxDurationAndDistance": {
                        "distance": 19.8,
                        "distanceUnit": "KILOMETER",
                        "durationInSeconds": 1560
                      },
                      "traveller": {
                        "firstName": "Alex",
                        "lastName": "Traveller",
                        "email": "alex.traveller@example.com",
                        "phone": "+447700900123",
                        "meetAndGreetSignText": "Alex Traveller",
                        "driverComments": "Two suitcases and a stroller.",
                        "flightNumber": "TZ1234",
                        "trainNumber": null,
                        "shipName": null,
                        "languageIsoCode": "en",
                        "residenceCountryCode": "GB"
                      },
                      "travelAddons": [
                        {
                          "type": "MEET_GREET",
                          "amount": 1
                        }
                      ],
                      "status": "CANCELLED_FREE",
                      "cancellationDetails": {
                        "cancellable": false,
                        "freeCancellationUntil": "2026-11-30T14:30:00",
                        "freeCancellationWindowHours": 24
                      },
                      "priceSummary": {
                        "commission": 7.2,
                        "commissionVat": 0,
                        "price": 72,
                        "priceVat": 5.94,
                        "currency": "EUR",
                        "discountCode": null,
                        "discountAmount": 0,
                        "discountPercentage": 0,
                        "discountVat": 0
                      },
                      "customerServiceInfo": {
                        "supportPhoneNumber": "+442079460100"
                      },
                      "travellerAppUrl": "https://traveller.example.com/j/TZ7K4QM-1"
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    },
    "/journeys/{journeyId}": {
      "get": {
        "tags": [
          "Journeys"
        ],
        "summary": "Get journey by id",
        "description": "Retrieves a previously created journey",
        "operationId": "getJourneyById",
        "parameters": [
          {
            "name": "journeyId",
            "in": "path",
            "description": "The id of the journey to retrieve",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "X-Request-ID",
            "in": "header",
            "description": "The optional (ideally unique) request identifier used for later analysis or diagnostics",
            "required": false,
            "schema": {}
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JourneyDto"
                },
                "example": {
                  "id": 488213,
                  "code": "TZ7K4QM-1",
                  "quoteId": 7731201,
                  "vehicleCategory": "SEDAN",
                  "pickupTimeAdjustmentMethod": "FLIGHT_TRACKING",
                  "origin": {
                    "bookerEnteredAddress": "AMS",
                    "resolvedAddress": "Amsterdam Airport Schiphol (AMS), Evert van de Beekstraat 202, 1118 CP Schiphol, Netherlands",
                    "fullResolvedAddress": {
                      "streetName": "Evert van de Beekstraat",
                      "streetNumber": "202",
                      "city": "Schiphol",
                      "postalCode": "1118 CP",
                      "region": "Noord-Holland",
                      "countryCode": "NL",
                      "establishment": "Amsterdam Airport Schiphol"
                    },
                    "latitude": 52.3105,
                    "longitude": 4.7683,
                    "hub": true,
                    "iataCode": "AMS",
                    "usedResolutionMethod": "IATA_CODE"
                  },
                  "destination": {
                    "bookerEnteredAddress": "Herengracht 182, Amsterdam",
                    "resolvedAddress": "Herengracht 182, 1016 BR Amsterdam, Netherlands",
                    "fullResolvedAddress": {
                      "streetName": "Herengracht",
                      "streetNumber": "182",
                      "city": "Amsterdam",
                      "postalCode": "1016 BR",
                      "region": "Noord-Holland",
                      "countryCode": "NL",
                      "establishment": "Hotel Example Canal House"
                    },
                    "latitude": 52.3738,
                    "longitude": 4.8862,
                    "hub": false,
                    "iataCode": null,
                    "usedResolutionMethod": "ADDRESS_PHRASE"
                  },
                  "pickup": {
                    "localTime": "2026-12-01T14:30:00",
                    "timeZone": "Europe/Amsterdam"
                  },
                  "transferCompany": {
                    "id": 2290,
                    "name": "Canal City Transfers",
                    "phoneNumber": "+442079460150"
                  },
                  "driver": {
                    "id": 77015,
                    "name": "Jordan Driver",
                    "phoneNumber": "+447700900199",
                    "vehicleId": 88120,
                    "vehicleMake": "Toyota",
                    "vehicleModel": "Corolla Touring",
                    "vehicleSeries": "Hybrid",
                    "vehicleLicensePlate": "TZ-123-X",
                    "lastKnownPosition": {
                      "latitude": 52.3462,
                      "longitude": 4.9171
                    }
                  },
                  "meetingPoint": {
                    "id": 2561,
                    "type": "HUB",
                    "name": "Schiphol Plaza meeting point",
                    "description": "Walk to the Meeting Point sign in Schiphol Plaza, opposite arrivals 3. Your driver waits there with a name sign.",
                    "lat": 52.3094,
                    "lng": 4.7622,
                    "files": [
                      {
                        "id": 99102,
                        "fileType": "MAP",
                        "url": "https://cdn.example.com/meeting-points/2561/map.png"
                      }
                    ]
                  },
                  "approxDurationAndDistance": {
                    "distance": 19.8,
                    "distanceUnit": "KILOMETER",
                    "durationInSeconds": 1560
                  },
                  "traveller": {
                    "firstName": "Alex",
                    "lastName": "Traveller",
                    "email": "alex.traveller@example.com",
                    "phone": "+447700900123",
                    "meetAndGreetSignText": "Alex Traveller",
                    "driverComments": "Two suitcases and a stroller.",
                    "flightNumber": "TZ1234",
                    "trainNumber": null,
                    "shipName": null,
                    "languageIsoCode": "en",
                    "residenceCountryCode": "GB"
                  },
                  "travelAddons": [
                    {
                      "type": "MEET_GREET",
                      "amount": 1
                    }
                  ],
                  "status": "PLANNED",
                  "cancellationDetails": {
                    "cancellable": true,
                    "freeCancellationUntil": "2026-11-30T14:30:00",
                    "freeCancellationWindowHours": 24
                  },
                  "priceSummary": {
                    "commission": 7.2,
                    "commissionVat": 0,
                    "price": 72,
                    "priceVat": 5.94,
                    "currency": "EUR",
                    "discountCode": null,
                    "discountAmount": 0,
                    "discountPercentage": 0,
                    "discountVat": 0
                  },
                  "customerServiceInfo": {
                    "supportPhoneNumber": "+442079460100"
                  },
                  "travellerAppUrl": "https://traveller.example.com/j/TZ7K4QM-1"
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    },
    "/journeys/{journeyId}/voucher": {
      "get": {
        "tags": [
          "Journeys"
        ],
        "summary": "Get journey voucher",
        "description": "Retrieves a PDF voucher for the given journey. If a voucher is not yet available the endpoint will return a status 204. If the voucher is available it will return a status 303 with the Location header pointing to the download location. If the journey is modified a new voucher will be issued - be sure to obtain the new voucher.",
        "operationId": "getVoucher",
        "parameters": [
          {
            "name": "journeyId",
            "in": "path",
            "description": "The id of the journey for which to retrieve the voucher",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "X-Request-ID",
            "in": "header",
            "description": "The optional (ideally unique) request identifier used for later analysis or diagnostics",
            "required": false,
            "schema": {}
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    },
    "/journeys/{journeyId}/available-addons": {
      "get": {
        "tags": [
          "Journeys"
        ],
        "summary": "Get available add-ons",
        "description": "Retrieves a list of add-ons available to be added through journey changes for the current journey",
        "operationId": "getAvailableAddonsForJourney",
        "parameters": [
          {
            "name": "journeyId",
            "in": "path",
            "description": "The id of the journey to retrieve",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "X-Request-ID",
            "in": "header",
            "description": "The optional (ideally unique) request identifier used for later analysis or diagnostics",
            "required": false,
            "schema": {}
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AvailableTravelAddonsDto"
                },
                "example": {
                  "combinedSeatBasedAddonCapacity": 2,
                  "availableTravelAddons": [
                    {
                      "type": "MEET_GREET",
                      "maximumAllowedAmount": 1,
                      "currentlySelectedAmount": 1
                    },
                    {
                      "type": "CHILD_SEAT",
                      "maximumAllowedAmount": 2,
                      "currentlySelectedAmount": 0
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    },
    "/flights/search": {
      "get": {
        "tags": [
          "Flights"
        ],
        "summary": "Search flights",
        "description": "Retrieves a list of flights for the provided parameters. At minimum the arrival and departure airport should be specified, along with an arrival or departure date.",
        "operationId": "searchFlights",
        "parameters": [
          {
            "name": "airlineIataCode",
            "in": "query",
            "description": "The 2-letter IATA code of the airline, i.e. 'KL' for KLM",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "arrivalAirportIataCode",
            "in": "query",
            "description": "The 3-letter IATA code of the airport on which the flight is arriving",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "departureAirportIataCode",
            "in": "query",
            "description": "The 3-letter IATA code of the airport from which the flight is departing",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "arrivalDate",
            "in": "query",
            "description": "The arrival date (local to the arrival airport)",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "departureDate",
            "in": "query",
            "description": "The departure date (local to the departure airport)",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Request-ID",
            "in": "header",
            "description": "The optional (ideally unique) request identifier used for later analysis or diagnostics",
            "required": false,
            "schema": {}
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/FlightDto"
                  }
                },
                "example": [
                  {
                    "flightDesignators": [
                      {
                        "airlineCode": "TZ",
                        "flightNumber": "1234",
                        "primary": true,
                        "airlineName": "Example Air"
                      }
                    ],
                    "scheduledDepartureTimeLocal": "2026-12-01T11:15:00",
                    "departureAirportIataCode": "LHR",
                    "scheduledArrivalTimeLocal": "2026-12-01T13:40:00",
                    "arrivalAirportIataCode": "AMS",
                    "departureAirportCountryCode": "GB",
                    "arrivalAirportCountryCode": "NL"
                  }
                ]
              }
            }
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    },
    "/flights/resolve": {
      "get": {
        "tags": [
          "Flights"
        ],
        "summary": "Resolve flight",
        "description": "Resolves a flight using the flight designator and arrival or departure date.",
        "operationId": "resolveFlight",
        "parameters": [
          {
            "name": "flightDesignator",
            "in": "query",
            "description": "The flight number in IATA format (i.e. KL123)",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "departureDate",
            "in": "query",
            "description": "The departure date (local to the departing airport)",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "arrivalDate",
            "in": "query",
            "description": "The arrival date (local to the arrival airport)",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Request-ID",
            "in": "header",
            "description": "The optional (ideally unique) request identifier used for later analysis or diagnostics",
            "required": false,
            "schema": {}
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FlightDto"
                },
                "example": {
                  "flightDesignators": [
                    {
                      "airlineCode": "TZ",
                      "flightNumber": "1234",
                      "primary": true,
                      "airlineName": "Example Air"
                    }
                  ],
                  "scheduledDepartureTimeLocal": "2026-12-01T11:15:00",
                  "departureAirportIataCode": "LHR",
                  "scheduledArrivalTimeLocal": "2026-12-01T13:40:00",
                  "arrivalAirportIataCode": "AMS",
                  "departureAirportCountryCode": "GB",
                  "arrivalAirportCountryCode": "NL"
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    },
    "/bookings/{id}": {
      "get": {
        "tags": [
          "Bookings"
        ],
        "summary": "Get booking by id",
        "description": "Retrieves a previously created booking including associated journeys",
        "operationId": "getBookingById",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "The id of the booking to retrieve",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "X-Request-ID",
            "in": "header",
            "description": "The optional (ideally unique) request identifier used for later analysis or diagnostics",
            "required": false,
            "schema": {}
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BookingDto"
                },
                "example": {
                  "id": 312840,
                  "code": "TZ7K4QM",
                  "partnerReference": "ORDER-10023",
                  "partnerId": 4100,
                  "travelIntent": "LEISURE",
                  "bookerInfo": {
                    "firstName": "Alex",
                    "lastName": "Traveller",
                    "email": "alex.traveller@example.com",
                    "phone": "+447700900123",
                    "companyName": null,
                    "reference": "ORDER-10023",
                    "languageIsoCode": "en"
                  },
                  "journeys": [
                    {
                      "id": 488213,
                      "code": "TZ7K4QM-1",
                      "quoteId": 7731201,
                      "vehicleCategory": "SEDAN",
                      "pickupTimeAdjustmentMethod": "FLIGHT_TRACKING",
                      "origin": {
                        "bookerEnteredAddress": "AMS",
                        "resolvedAddress": "Amsterdam Airport Schiphol (AMS), Evert van de Beekstraat 202, 1118 CP Schiphol, Netherlands",
                        "fullResolvedAddress": {
                          "streetName": "Evert van de Beekstraat",
                          "streetNumber": "202",
                          "city": "Schiphol",
                          "postalCode": "1118 CP",
                          "region": "Noord-Holland",
                          "countryCode": "NL",
                          "establishment": "Amsterdam Airport Schiphol"
                        },
                        "latitude": 52.3105,
                        "longitude": 4.7683,
                        "hub": true,
                        "iataCode": "AMS",
                        "usedResolutionMethod": "IATA_CODE"
                      },
                      "destination": {
                        "bookerEnteredAddress": "Herengracht 182, Amsterdam",
                        "resolvedAddress": "Herengracht 182, 1016 BR Amsterdam, Netherlands",
                        "fullResolvedAddress": {
                          "streetName": "Herengracht",
                          "streetNumber": "182",
                          "city": "Amsterdam",
                          "postalCode": "1016 BR",
                          "region": "Noord-Holland",
                          "countryCode": "NL",
                          "establishment": "Hotel Example Canal House"
                        },
                        "latitude": 52.3738,
                        "longitude": 4.8862,
                        "hub": false,
                        "iataCode": null,
                        "usedResolutionMethod": "ADDRESS_PHRASE"
                      },
                      "pickup": {
                        "localTime": "2026-12-01T14:30:00",
                        "timeZone": "Europe/Amsterdam"
                      },
                      "transferCompany": {
                        "id": 2290,
                        "name": "Canal City Transfers",
                        "phoneNumber": "+442079460150"
                      },
                      "driver": null,
                      "meetingPoint": {
                        "id": 2561,
                        "type": "HUB",
                        "name": "Schiphol Plaza meeting point",
                        "description": "Walk to the Meeting Point sign in Schiphol Plaza, opposite arrivals 3. Your driver waits there with a name sign.",
                        "lat": 52.3094,
                        "lng": 4.7622,
                        "files": [
                          {
                            "id": 99102,
                            "fileType": "MAP",
                            "url": "https://cdn.example.com/meeting-points/2561/map.png"
                          }
                        ]
                      },
                      "approxDurationAndDistance": {
                        "distance": 19.8,
                        "distanceUnit": "KILOMETER",
                        "durationInSeconds": 1560
                      },
                      "traveller": {
                        "firstName": "Alex",
                        "lastName": "Traveller",
                        "email": "alex.traveller@example.com",
                        "phone": "+447700900123",
                        "meetAndGreetSignText": "Alex Traveller",
                        "driverComments": "Two suitcases and a stroller.",
                        "flightNumber": "TZ1234",
                        "trainNumber": null,
                        "shipName": null,
                        "languageIsoCode": "en",
                        "residenceCountryCode": "GB"
                      },
                      "travelAddons": [
                        {
                          "type": "MEET_GREET",
                          "amount": 1
                        }
                      ],
                      "status": "CONFIRMED",
                      "cancellationDetails": {
                        "cancellable": true,
                        "freeCancellationUntil": "2026-11-30T14:30:00",
                        "freeCancellationWindowHours": 24
                      },
                      "priceSummary": {
                        "commission": 7.2,
                        "commissionVat": 0,
                        "price": 72,
                        "priceVat": 5.94,
                        "currency": "EUR",
                        "discountCode": null,
                        "discountAmount": 0,
                        "discountPercentage": 0,
                        "discountVat": 0
                      },
                      "customerServiceInfo": {
                        "supportPhoneNumber": "+442079460100"
                      },
                      "travellerAppUrl": "https://traveller.example.com/j/TZ7K4QM-1"
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "CoordinateDto": {
        "type": "object",
        "properties": {
          "lat": {
            "type": "number",
            "format": "double",
            "maximum": 90,
            "minimum": -90
          },
          "lng": {
            "type": "number",
            "format": "double",
            "maximum": 180,
            "minimum": -180
          }
        },
        "required": [
          "lat",
          "lng"
        ]
      },
      "LocationAddressDto": {
        "type": "object",
        "properties": {
          "addressSearchPhrase": {
            "type": "string",
            "minLength": 1
          },
          "countryCode": {
            "type": "string",
            "maxLength": 2,
            "minLength": 0
          }
        },
        "required": [
          "addressSearchPhrase"
        ]
      },
      "LocationInputDto": {
        "type": "object",
        "properties": {
          "address": {
            "$ref": "#/components/schemas/LocationAddressDto"
          },
          "coordinate": {
            "$ref": "#/components/schemas/CoordinateDto"
          },
          "transferzLocationId": {
            "type": "integer",
            "format": "int64"
          },
          "hereId": {
            "type": "string"
          },
          "googlePlaceId": {
            "type": "string"
          },
          "tomTomId": {
            "type": "string"
          },
          "iataCode": {
            "type": "string"
          },
          "icaoCode": {
            "type": "string"
          },
          "giataId": {
            "type": "string"
          },
          "ttiCode": {
            "type": "string"
          }
        }
      },
      "QuoteRequestDto": {
        "type": "object",
        "properties": {
          "partnerId": {
            "type": "integer",
            "format": "int64"
          },
          "origin": {
            "$ref": "#/components/schemas/LocationInputDto"
          },
          "destination": {
            "$ref": "#/components/schemas/LocationInputDto"
          },
          "pickupDateTime": {
            "type": "string",
            "format": "date-time"
          },
          "adultPassengers": {
            "type": "integer",
            "format": "int32"
          },
          "childPassengers": {
            "type": "integer",
            "format": "int32"
          },
          "infantPassengers": {
            "type": "integer",
            "format": "int32"
          },
          "checkedLuggage": {
            "type": "integer",
            "format": "int32"
          },
          "carryOnLuggage": {
            "type": "integer",
            "format": "int32"
          },
          "source": {
            "type": "string",
            "description": "An optional value to indicate the source of the quote request from within the partner's platform."
          },
          "discountCode": {
            "type": "string",
            "description": "Discount code to be applied to the quote. If the discount code is not valid, the quote will be generated without applying the discount."
          },
          "requireInstantConfirmation": {
            "type": "boolean",
            "description": "Setting this field to true means only quotes with instant confirmation availability will be returned."
          },
          "limitToVehicleCategory": {
            "type": "string",
            "deprecated": true,
            "enum": [
              "SEDAN",
              "STATIONWAGON",
              "SUV",
              "MINIVAN",
              "BUSINESS_LIMOUSINE",
              "BUSINESS_SEDAN",
              "STRETCH_LIMOUSINE",
              "MINIBUS",
              "TOURING_CAR",
              "STANDARD_ELECTRIC_CAR",
              "EXCLUSIVE_MINIVAN",
              "LUXURY_SEDAN",
              "HIGH_END_ELECTRIC_CAR",
              "SHUTTLE",
              "ECONOMY_SEDAN",
              "HELICOPTER",
              "VAN",
              "BUS",
              "MPV",
              "COACH",
              "SPEEDY_SHUTTLE",
              "EVENT_SHUTTLE",
              "DIRECT_SHUTTLE"
            ]
          },
          "currencyCode": {
            "type": "string"
          },
          "limitToVehicleCategories": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "SEDAN",
                "STATIONWAGON",
                "SUV",
                "MINIVAN",
                "BUSINESS_LIMOUSINE",
                "BUSINESS_SEDAN",
                "STRETCH_LIMOUSINE",
                "MINIBUS",
                "TOURING_CAR",
                "STANDARD_ELECTRIC_CAR",
                "EXCLUSIVE_MINIVAN",
                "LUXURY_SEDAN",
                "HIGH_END_ELECTRIC_CAR",
                "SHUTTLE",
                "ECONOMY_SEDAN",
                "HELICOPTER",
                "VAN",
                "BUS",
                "MPV",
                "COACH",
                "SPEEDY_SHUTTLE",
                "EVENT_SHUTTLE",
                "DIRECT_SHUTTLE"
              ]
            },
            "uniqueItems": true
          }
        },
        "required": [
          "destination",
          "origin",
          "pickupDateTime"
        ]
      },
      "AddressDto": {
        "type": "object",
        "properties": {
          "streetName": {
            "type": "string"
          },
          "streetNumber": {
            "type": "string"
          },
          "city": {
            "type": "string"
          },
          "postalCode": {
            "type": "string"
          },
          "region": {
            "type": "string"
          },
          "countryCode": {
            "type": "string"
          },
          "establishment": {
            "type": "string"
          }
        }
      },
      "LocationDto": {
        "type": "object",
        "properties": {
          "bookerEnteredAddress": {
            "type": "string"
          },
          "resolvedAddress": {
            "type": "string"
          },
          "fullResolvedAddress": {
            "$ref": "#/components/schemas/AddressDto"
          },
          "latitude": {
            "type": "number",
            "format": "double"
          },
          "longitude": {
            "type": "number",
            "format": "double"
          },
          "hub": {
            "type": "boolean"
          },
          "iataCode": {
            "type": "string"
          },
          "usedResolutionMethod": {
            "type": "string",
            "enum": [
              "TRANSFERZ_LOCATION_ID",
              "ADDRESS_PHRASE",
              "COORDINATES",
              "GIATA_ID",
              "GOOGLE_PLACE_ID",
              "TOMTOM_ID",
              "TTI_CODE",
              "HERE_ID",
              "ICAO_CODE",
              "IATA_CODE"
            ]
          }
        }
      },
      "QuoteDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "vehicleCategory": {
            "type": "string",
            "enum": [
              "SEDAN",
              "STATIONWAGON",
              "SUV",
              "MINIVAN",
              "BUSINESS_LIMOUSINE",
              "BUSINESS_SEDAN",
              "STRETCH_LIMOUSINE",
              "MINIBUS",
              "TOURING_CAR",
              "STANDARD_ELECTRIC_CAR",
              "EXCLUSIVE_MINIVAN",
              "LUXURY_SEDAN",
              "HIGH_END_ELECTRIC_CAR",
              "SHUTTLE",
              "ECONOMY_SEDAN",
              "HELICOPTER",
              "VAN",
              "BUS",
              "MPV",
              "COACH",
              "SPEEDY_SHUTTLE",
              "EVENT_SHUTTLE",
              "DIRECT_SHUTTLE"
            ]
          },
          "vehicleImageUrl": {
            "type": "string"
          },
          "vehicleModels": {
            "type": "string"
          },
          "passengerCapacity": {
            "type": "integer",
            "format": "int32"
          },
          "luggageCapacity": {
            "type": "number"
          },
          "price": {
            "type": "number"
          },
          "vat": {
            "type": "number"
          },
          "commission": {
            "type": "number"
          },
          "commissionVat": {
            "type": "number"
          },
          "discount": {
            "type": "number"
          },
          "discountPercentage": {
            "type": "number"
          },
          "discountVat": {
            "type": "number"
          },
          "currencyCode": {
            "type": "string"
          },
          "combinedSeatBasedAddonCapacity": {
            "type": "integer",
            "format": "int32"
          },
          "expires": {
            "type": "string",
            "format": "date-time"
          },
          "availableTravelAddons": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/QuoteTravelAddonDto"
            }
          },
          "includedWaitingTimeInMinutes": {
            "type": "integer",
            "format": "int32"
          },
          "freeCancellationUntil": {
            "type": "string",
            "format": "date-time"
          },
          "instantConfirmation": {
            "type": "boolean"
          },
          "pricePerPassenger": {
            "type": "boolean"
          },
          "combinedBabyAndBoosterSeatsCapacity": {
            "type": "integer",
            "format": "int32",
            "deprecated": true,
            "description": "This field is deprecated and has been replaced by 'combinedSeatBasedAddonCapacity'"
          }
        }
      },
      "QuoteResponseDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "origin": {
            "$ref": "#/components/schemas/LocationDto"
          },
          "destination": {
            "$ref": "#/components/schemas/LocationDto"
          },
          "quotes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/QuoteDto"
            }
          }
        }
      },
      "QuoteTravelAddonDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "type": {
            "type": "string",
            "enum": [
              "MEET_GREET",
              "BABY_SEAT",
              "BOOSTER_SEAT",
              "PETS",
              "EXTRA_STOP",
              "SPECIAL_LUGGAGE",
              "CARBON_EMISSION_COMPENSATION",
              "CHILD_SEAT"
            ]
          },
          "price": {
            "type": "number"
          },
          "commission": {
            "type": "number"
          },
          "maxAllowed": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "SuggestedPickupTimeRequestDto": {
        "type": "object",
        "properties": {
          "origin": {
            "$ref": "#/components/schemas/LocationInputDto"
          },
          "destination": {
            "$ref": "#/components/schemas/LocationInputDto"
          },
          "departureOrArrivalTime": {
            "type": "string",
            "format": "date-time"
          },
          "travelType": {
            "type": "string",
            "enum": [
              "DOMESTIC",
              "INTERNATIONAL"
            ]
          },
          "onlyCarryOnLuggage": {
            "type": "boolean"
          },
          "roundToNearestMinutes": {
            "type": "integer",
            "format": "int32"
          },
          "flightNumber": {
            "type": "string"
          }
        },
        "required": [
          "departureOrArrivalTime",
          "destination",
          "origin"
        ]
      },
      "SuggestedPickupTimeResponseDto": {
        "type": "object",
        "properties": {
          "directionality": {
            "type": "string",
            "enum": [
              "DEPARTURE",
              "ARRIVAL"
            ]
          },
          "suggestedPickupTime": {
            "type": "string",
            "format": "date-time"
          },
          "distanceInMeters": {
            "type": "integer",
            "format": "int32"
          },
          "durationInMinutes": {
            "type": "integer",
            "format": "int32"
          },
          "bufferTime": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "ChangeLuggageDto": {
        "type": "object",
        "properties": {
          "checkedLuggage": {
            "type": "integer",
            "format": "int32"
          },
          "carryOnLuggage": {
            "type": "integer",
            "format": "int32"
          }
        },
        "required": [
          "carryOnLuggage",
          "checkedLuggage"
        ]
      },
      "ChangePassengersDto": {
        "type": "object",
        "properties": {
          "adultPassengers": {
            "type": "integer",
            "format": "int32"
          },
          "childPassengers": {
            "type": "integer",
            "format": "int32"
          },
          "infantPassengers": {
            "type": "integer",
            "format": "int32"
          }
        },
        "required": [
          "adultPassengers",
          "childPassengers",
          "infantPassengers"
        ]
      },
      "JourneyChangeRequestDto": {
        "type": "object",
        "properties": {
          "pickupDate": {
            "type": "string",
            "format": "date-time"
          },
          "travellerInfo": {
            "$ref": "#/components/schemas/TravellerExtendedInfoDto"
          },
          "origin": {
            "$ref": "#/components/schemas/LocationInputDto"
          },
          "destination": {
            "$ref": "#/components/schemas/LocationInputDto"
          },
          "travelAddons": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TravelAddonDto"
            }
          }
        }
      },
      "TravelAddonDto": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "MEET_GREET",
              "BABY_SEAT",
              "BOOSTER_SEAT",
              "PETS",
              "EXTRA_STOP",
              "SPECIAL_LUGGAGE",
              "CARBON_EMISSION_COMPENSATION",
              "CHILD_SEAT"
            ]
          },
          "amount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "TravellerExtendedInfoDto": {
        "type": "object",
        "properties": {
          "firstName": {
            "type": "string",
            "maxLength": 255,
            "minLength": 0
          },
          "lastName": {
            "type": "string",
            "maxLength": 255,
            "minLength": 0
          },
          "email": {
            "type": "string",
            "maxLength": 255,
            "minLength": 6
          },
          "phone": {
            "type": "string",
            "maxLength": 255,
            "minLength": 0
          },
          "meetAndGreetSignText": {
            "type": "string"
          },
          "driverComments": {
            "type": "string"
          },
          "flightNumber": {
            "type": "string",
            "maxLength": 255,
            "minLength": 0
          },
          "trainNumber": {
            "type": "string",
            "maxLength": 255,
            "minLength": 0
          },
          "shipName": {
            "type": "string",
            "maxLength": 255,
            "minLength": 0
          },
          "languageIsoCode": {
            "type": "string",
            "maxLength": 2,
            "minLength": 2
          },
          "residenceCountryCode": {
            "type": "string",
            "maxLength": 2,
            "minLength": 2
          },
          "passengers": {
            "$ref": "#/components/schemas/ChangePassengersDto"
          },
          "luggage": {
            "$ref": "#/components/schemas/ChangeLuggageDto"
          }
        },
        "required": [
          "email"
        ]
      },
      "JourneyChangeResponseDto": {
        "type": "object",
        "properties": {
          "changeId": {
            "type": "integer",
            "format": "int64"
          },
          "additionalPaymentRequired": {
            "type": "boolean"
          },
          "previousPrice": {
            "$ref": "#/components/schemas/PriceSummaryDto"
          },
          "newPrice": {
            "$ref": "#/components/schemas/PriceSummaryDto"
          }
        }
      },
      "PriceSummaryDto": {
        "type": "object",
        "properties": {
          "commission": {
            "type": "number"
          },
          "commissionVat": {
            "type": "number"
          },
          "price": {
            "type": "number"
          },
          "priceVat": {
            "type": "number"
          },
          "currency": {
            "type": "string"
          },
          "discountCode": {
            "type": "string"
          },
          "discountAmount": {
            "type": "number"
          },
          "discountPercentage": {
            "type": "number"
          },
          "discountVat": {
            "type": "number"
          }
        }
      },
      "CancellationDetailsDto": {
        "type": "object",
        "properties": {
          "cancellable": {
            "type": "boolean"
          },
          "freeCancellationUntil": {
            "type": "string",
            "format": "date-time"
          },
          "freeCancellationWindowHours": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "CustomerServiceInfoDto": {
        "type": "object",
        "properties": {
          "supportPhoneNumber": {
            "type": "string"
          }
        }
      },
      "DriverInfoDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "name": {
            "type": "string"
          },
          "phoneNumber": {
            "type": "string"
          },
          "vehicleId": {
            "type": "integer",
            "format": "int64"
          },
          "vehicleMake": {
            "type": "string"
          },
          "vehicleModel": {
            "type": "string"
          },
          "vehicleSeries": {
            "type": "string"
          },
          "vehicleLicensePlate": {
            "type": "string"
          },
          "lastKnownPosition": {
            "$ref": "#/components/schemas/PositionDto"
          }
        }
      },
      "DurationAndDistanceDto": {
        "type": "object",
        "properties": {
          "distance": {
            "type": "number"
          },
          "distanceUnit": {
            "type": "string",
            "enum": [
              "METER",
              "FEET",
              "KILOMETER",
              "MILE"
            ]
          },
          "durationInSeconds": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "JourneyDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "code": {
            "type": "string"
          },
          "quoteId": {
            "type": "integer",
            "format": "int64"
          },
          "vehicleCategory": {
            "type": "string",
            "enum": [
              "SEDAN",
              "STATIONWAGON",
              "SUV",
              "MINIVAN",
              "BUSINESS_LIMOUSINE",
              "BUSINESS_SEDAN",
              "STRETCH_LIMOUSINE",
              "MINIBUS",
              "TOURING_CAR",
              "STANDARD_ELECTRIC_CAR",
              "EXCLUSIVE_MINIVAN",
              "LUXURY_SEDAN",
              "HIGH_END_ELECTRIC_CAR",
              "SHUTTLE",
              "ECONOMY_SEDAN",
              "HELICOPTER",
              "VAN",
              "BUS",
              "MPV",
              "COACH",
              "SPEEDY_SHUTTLE",
              "EVENT_SHUTTLE",
              "DIRECT_SHUTTLE"
            ]
          },
          "pickupTimeAdjustmentMethod": {
            "type": "string",
            "enum": [
              "PENDING",
              "NONE",
              "FLIGHT_TRACKING",
              "MANUAL"
            ]
          },
          "origin": {
            "$ref": "#/components/schemas/LocationDto"
          },
          "destination": {
            "$ref": "#/components/schemas/LocationDto"
          },
          "pickup": {
            "$ref": "#/components/schemas/PickupDto"
          },
          "transferCompany": {
            "$ref": "#/components/schemas/TransferCompanyInfoDto"
          },
          "driver": {
            "$ref": "#/components/schemas/DriverInfoDto"
          },
          "meetingPoint": {
            "$ref": "#/components/schemas/MeetingPointInfoDto"
          },
          "approxDurationAndDistance": {
            "$ref": "#/components/schemas/DurationAndDistanceDto"
          },
          "traveller": {
            "$ref": "#/components/schemas/TravellerInfoDto"
          },
          "travelAddons": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TravelAddonDto"
            }
          },
          "status": {
            "type": "string",
            "enum": [
              "NOT_PAID",
              "AWAITING_APPROVAL",
              "PENDING",
              "CONFIRMED",
              "PLANNED",
              "DRIVER_UNDERWAY",
              "DRIVER_ARRIVED",
              "JOURNEY_IN_PROGRESS",
              "COMPLETED",
              "CANCELLED_FREE",
              "CANCELLED_WITH_COSTS",
              "BOOKER_CANCELLED",
              "SUPPLIER_CANCELLED"
            ]
          },
          "cancellationDetails": {
            "$ref": "#/components/schemas/CancellationDetailsDto"
          },
          "priceSummary": {
            "$ref": "#/components/schemas/PriceSummaryDto"
          },
          "customerServiceInfo": {
            "$ref": "#/components/schemas/CustomerServiceInfoDto"
          },
          "travellerAppUrl": {
            "type": "string"
          }
        }
      },
      "MeetingPointFileDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "fileType": {
            "type": "string",
            "enum": [
              "MAP",
              "DESK",
              "PICKUP",
              "OTHER"
            ]
          },
          "url": {
            "type": "string"
          }
        }
      },
      "MeetingPointInfoDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "type": {
            "type": "string",
            "enum": [
              "HUB",
              "TRANSFER_COMPANY"
            ]
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "lat": {
            "type": "number",
            "format": "double"
          },
          "lng": {
            "type": "number",
            "format": "double"
          },
          "files": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MeetingPointFileDto"
            }
          }
        }
      },
      "PickupDto": {
        "type": "object",
        "properties": {
          "localTime": {
            "type": "string",
            "format": "date-time"
          },
          "timeZone": {
            "type": "string"
          }
        }
      },
      "PositionDto": {
        "type": "object",
        "properties": {
          "latitude": {
            "type": "number",
            "format": "double"
          },
          "longitude": {
            "type": "number",
            "format": "double"
          }
        }
      },
      "TransferCompanyInfoDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "name": {
            "type": "string"
          },
          "phoneNumber": {
            "type": "string"
          }
        }
      },
      "TravellerInfoDto": {
        "type": "object",
        "properties": {
          "firstName": {
            "type": "string",
            "maxLength": 255,
            "minLength": 0
          },
          "lastName": {
            "type": "string",
            "maxLength": 255,
            "minLength": 0
          },
          "email": {
            "type": "string",
            "maxLength": 255,
            "minLength": 6
          },
          "phone": {
            "type": "string",
            "maxLength": 255,
            "minLength": 0
          },
          "meetAndGreetSignText": {
            "type": "string"
          },
          "driverComments": {
            "type": "string"
          },
          "flightNumber": {
            "type": "string",
            "maxLength": 255,
            "minLength": 0
          },
          "trainNumber": {
            "type": "string",
            "maxLength": 255,
            "minLength": 0
          },
          "shipName": {
            "type": "string",
            "maxLength": 255,
            "minLength": 0
          },
          "languageIsoCode": {
            "type": "string",
            "maxLength": 2,
            "minLength": 2
          },
          "residenceCountryCode": {
            "type": "string",
            "maxLength": 2,
            "minLength": 2
          }
        },
        "required": [
          "email"
        ]
      },
      "PaymentLinkDto": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string"
          },
          "expiresAt": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "CancelJourneyDto": {
        "type": "object",
        "properties": {
          "reason": {
            "type": "string",
            "enum": [
              "NOT_NEEDED_ANYMORE",
              "DRIVER_NO_SHOW",
              "NO_AVAILABILITY",
              "ADDRESS_INVALID",
              "INSUFFICIENT_TRAVELLER_DETAILS",
              "TECHNICAL_ISSUE",
              "TRAVELLER_NO_SHOW",
              "PRICE_CALCULATION_ERROR",
              "STRIKE_OR_ROAD_CLOSURE",
              "NO_FLIGHT_NUMBER",
              "ADD_ON_ISSUE",
              "CANT_FULFILL_CUSTOMER_REQUEST",
              "PAX_BAGS_CONFIGURATION",
              "FORCE_MAJEURE",
              "OTHER"
            ]
          },
          "acceptCharges": {
            "type": "boolean"
          }
        },
        "required": [
          "reason"
        ]
      },
      "BookerInfoDto": {
        "type": "object",
        "properties": {
          "firstName": {
            "type": "string",
            "maxLength": 255,
            "minLength": 0
          },
          "lastName": {
            "type": "string",
            "maxLength": 255,
            "minLength": 0
          },
          "email": {
            "type": "string",
            "maxLength": 255,
            "minLength": 6
          },
          "phone": {
            "type": "string",
            "maxLength": 255,
            "minLength": 0
          },
          "companyName": {
            "type": "string",
            "maxLength": 255,
            "minLength": 0
          },
          "reference": {
            "type": "string",
            "maxLength": 255,
            "minLength": 0
          },
          "languageIsoCode": {
            "type": "string",
            "maxLength": 2,
            "minLength": 2
          }
        },
        "required": [
          "email"
        ]
      },
      "BookingQuoteDto": {
        "type": "object",
        "properties": {
          "quoteId": {
            "type": "integer",
            "format": "int64"
          },
          "traveller": {
            "$ref": "#/components/schemas/TravellerInfoDto"
          },
          "travelAddons": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BookingQuoteTravelAddonDto"
            }
          }
        },
        "required": [
          "quoteId",
          "traveller"
        ]
      },
      "BookingQuoteTravelAddonDto": {
        "type": "object",
        "properties": {
          "quoteTravelAddonId": {
            "type": "integer",
            "format": "int64"
          },
          "amount": {
            "type": "integer",
            "format": "int32"
          }
        },
        "required": [
          "amount",
          "quoteTravelAddonId"
        ]
      },
      "CreateBookingDto": {
        "type": "object",
        "properties": {
          "booker": {
            "$ref": "#/components/schemas/BookerInfoDto"
          },
          "quotes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BookingQuoteDto"
            },
            "maxItems": 2147483647,
            "minItems": 1
          },
          "partnerReference": {
            "type": "string"
          },
          "travelIntent": {
            "type": "string",
            "enum": [
              "BUSINESS",
              "LEISURE",
              "UNKNOWN"
            ]
          }
        },
        "required": [
          "booker",
          "partnerReference",
          "quotes"
        ]
      },
      "BookingDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "code": {
            "type": "string"
          },
          "partnerReference": {
            "type": "string"
          },
          "partnerId": {
            "type": "integer",
            "format": "int64"
          },
          "travelIntent": {
            "type": "string",
            "enum": [
              "BUSINESS",
              "LEISURE",
              "UNKNOWN"
            ]
          },
          "bookerInfo": {
            "$ref": "#/components/schemas/BookerInfoDto"
          },
          "journeys": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/JourneyDto"
            }
          }
        }
      },
      "PayByStripeConnectDto": {
        "type": "object",
        "properties": {
          "paymentIntent": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "paymentIntent"
        ]
      },
      "RequestPaymentLinkDto": {
        "type": "object",
        "properties": {
          "locale": {
            "type": "string"
          },
          "returnUrl": {
            "type": "string"
          }
        }
      },
      "CancelBookingDto": {
        "type": "object",
        "properties": {
          "reason": {
            "type": "string",
            "enum": [
              "NOT_NEEDED_ANYMORE",
              "DRIVER_NO_SHOW",
              "NO_AVAILABILITY",
              "ADDRESS_INVALID",
              "INSUFFICIENT_TRAVELLER_DETAILS",
              "TECHNICAL_ISSUE",
              "TRAVELLER_NO_SHOW",
              "PRICE_CALCULATION_ERROR",
              "STRIKE_OR_ROAD_CLOSURE",
              "NO_FLIGHT_NUMBER",
              "ADD_ON_ISSUE",
              "CANT_FULFILL_CUSTOMER_REQUEST",
              "PAX_BAGS_CONFIGURATION",
              "FORCE_MAJEURE",
              "OTHER"
            ]
          },
          "acceptCharges": {
            "type": "boolean"
          }
        },
        "required": [
          "reason"
        ]
      },
      "AvailableTravelAddonDto": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "MEET_GREET",
              "BABY_SEAT",
              "BOOSTER_SEAT",
              "PETS",
              "EXTRA_STOP",
              "SPECIAL_LUGGAGE",
              "CARBON_EMISSION_COMPENSATION",
              "CHILD_SEAT"
            ]
          },
          "maximumAllowedAmount": {
            "type": "integer",
            "format": "int32"
          },
          "currentlySelectedAmount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "AvailableTravelAddonsDto": {
        "type": "object",
        "properties": {
          "combinedSeatBasedAddonCapacity": {
            "type": "integer",
            "format": "int32"
          },
          "availableTravelAddons": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AvailableTravelAddonDto"
            }
          }
        }
      },
      "FlightDesignatorFlightDto": {
        "type": "object",
        "properties": {
          "airlineCode": {
            "type": "string"
          },
          "flightNumber": {
            "type": "string"
          },
          "primary": {
            "type": "boolean"
          },
          "airlineName": {
            "type": "string"
          }
        }
      },
      "FlightDto": {
        "type": "object",
        "properties": {
          "flightDesignators": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FlightDesignatorFlightDto"
            }
          },
          "scheduledDepartureTimeLocal": {
            "type": "string",
            "format": "date-time"
          },
          "departureAirportIataCode": {
            "type": "string"
          },
          "scheduledArrivalTimeLocal": {
            "type": "string",
            "format": "date-time"
          },
          "arrivalAirportIataCode": {
            "type": "string"
          },
          "departureAirportCountryCode": {
            "type": "string"
          },
          "arrivalAirportCountryCode": {
            "type": "string"
          }
        }
      }
    },
    "securitySchemes": {
      "apiKeyScheme": {
        "type": "apiKey",
        "description": "An API key",
        "name": "X-API-Key",
        "in": "header"
      }
    }
  }
}
