{
  "openapi": "3.1.0",
  "info": {
    "title": "Transfer Companies API",
    "description": "This API is used to rapidly develop API integrations with transfer companies.",
    "version": "0.9.0"
  },
  "servers": [
    {
      "url": "https://warpdrive.staging.transferz.com/transfercompanies",
      "description": "Transferz staging"
    }
  ],
  "tags": [
    {
      "name": "Offers",
      "description": "This API offers functionalities to retrieve, accept and decline offers for journeys."
    },
    {
      "name": "Journeys",
      "description": "This API offers functionalities to retrieve all relevant journey information"
    },
    {
      "name": "Actions",
      "description": "This API offers functionalities to retrieve and create actions"
    },
    {
      "name": "Zones",
      "description": "Provides geo zone and operation zone details by identifier"
    }
  ],
  "paths": {
    "/journeys/{id}/unassign-vehicle": {
      "put": {
        "tags": [
          "Journeys"
        ],
        "summary": "Unassign vehicle",
        "description": "Unassigns the currently selected vehicle from the journey driver",
        "operationId": "unassignVehicle",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "The id of the journey to update",
            "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/{id}/unassign-driver": {
      "put": {
        "tags": [
          "Journeys"
        ],
        "summary": "Unassign driver",
        "description": "Unassigns the currently selected driver from the journey",
        "operationId": "unassignDriver",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "The id of the journey to update",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "notifyBySms",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": true
            }
          },
          {
            "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/{id}/status/in-progress": {
      "put": {
        "tags": [
          "Journeys"
        ],
        "summary": "Update status to 'in progress'",
        "description": "Indicates the journey is in progress and driver is en-route to the drop-off point",
        "operationId": "updateStatusInProgress",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "The id of the journey to update",
            "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/DriverPositionDto"
              },
              "example": {
                "latitude": 52.3101,
                "longitude": 4.7655,
                "recordedAt": "2026-12-01T13:55:00"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    },
    "/journeys/{id}/status/driver-underway": {
      "put": {
        "tags": [
          "Journeys"
        ],
        "summary": "Update status to 'driver underway'",
        "description": "Indicates a driver is en-route to the pickup point",
        "operationId": "updateStatusDriverUnderway",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "The id of the journey to update",
            "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/DriverPositionDto"
              },
              "example": {
                "latitude": 52.3462,
                "longitude": 4.9171,
                "recordedAt": "2026-12-01T12:40:00"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    },
    "/journeys/{id}/status/driver-arrived": {
      "put": {
        "tags": [
          "Journeys"
        ],
        "summary": "Update status to 'driver arrived'",
        "description": "Indicates a driver has arrived at the pickup point and is waiting for the traveller",
        "operationId": "updateStatusDriverArrived",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "The id of the journey to update",
            "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/DriverPositionDto"
              },
              "example": {
                "latitude": 52.3091,
                "longitude": 4.7624,
                "recordedAt": "2026-12-01T13:12:05"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    },
    "/journeys/{id}/pickup-info": {
      "put": {
        "tags": [
          "Journeys"
        ],
        "summary": "Update pickup information",
        "description": "Updated pickup information for the given journey",
        "operationId": "updatePickupInfo",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "The id of the journey to update",
            "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/PickupInfoDto"
              },
              "example": {
                "pickupLocation": {
                  "title": "Bus bay B7",
                  "description": "Leave Schiphol Plaza through exit B and walk to bus bay B7. The driver waits next to the car.",
                  "latitude": 52.3089,
                  "longitude": 4.7631
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    },
    "/journeys/{id}/host-traveller-met": {
      "put": {
        "tags": [
          "Journeys"
        ],
        "summary": "Mark that the host met the traveller",
        "description": "Records the moment the host found the traveller, optionally with the position where it happened",
        "operationId": "markHostTravellerMet",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "The id of the journey to update",
            "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/HostTravellerMetDto"
              },
              "example": {
                "latitude": 52.3094,
                "longitude": 4.7622,
                "recordedAt": "2026-12-01T13:48:00"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    },
    "/journeys/{id}/driver-position": {
      "put": {
        "tags": [
          "Journeys"
        ],
        "summary": "Update driver position",
        "description": "Sets the last known driver position",
        "operationId": "updateLastKnownDriverPosition",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "The id of the journey to update",
            "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/DriverPositionDto"
              },
              "example": {
                "latitude": 52.3091,
                "longitude": 4.7624,
                "recordedAt": "2026-12-01T13:12:05"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    },
    "/journeys/{id}/complete": {
      "put": {
        "tags": [
          "Journeys"
        ],
        "summary": "Complete journey",
        "description": "Marks a journey as completed",
        "operationId": "completeJourney",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "The id of the journey to update",
            "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/DriverPositionDto"
              },
              "example": {
                "latitude": 52.3738,
                "longitude": 4.8862,
                "recordedAt": "2026-12-01T14:28:00"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    },
    "/journeys/{id}/assign-vehicle": {
      "put": {
        "tags": [
          "Journeys"
        ],
        "summary": "Assign vehicle",
        "description": "Assigns a vehicle to a journey driver",
        "operationId": "assignVehicle",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "The id of the journey to update",
            "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/AssignVehicleRequestDto"
              },
              "example": {
                "licensePlate": "TZ-123-X",
                "make": "Toyota",
                "model": "Corolla Touring",
                "series": "Hybrid",
                "reassign": false
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    },
    "/journeys/{id}/assign-driver": {
      "put": {
        "tags": [
          "Journeys"
        ],
        "summary": "Assign to driver",
        "description": "Assigns a journey to a driver and sends an optional SMS message",
        "operationId": "assignDriver",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "The id of the journey to update",
            "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/AssignDriverRequestDto"
              },
              "example": {
                "name": "Jordan Driver",
                "phoneNumber": "+447700900456",
                "notifyBySms": false,
                "reassign": false
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    },
    "/offers/{id}/decline": {
      "post": {
        "tags": [
          "Offers"
        ],
        "summary": "Decline offer",
        "description": "Declines an available offer",
        "operationId": "declineOffer",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "The id of the offer to decline",
            "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/DeclineOfferDto"
              },
              "example": {
                "reason": "NO_VEHICLE_AVAILABILITY",
                "description": "All sedans are booked on 1 December afternoon."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    },
    "/offers/{id}/accept": {
      "post": {
        "tags": [
          "Offers"
        ],
        "summary": "Accept offer",
        "description": "Accepts an available offer",
        "operationId": "acceptOffer",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "The id of the offer to accept",
            "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/AcceptOfferDto"
              },
              "example": {
                "meetingPointId": 2561,
                "type": "HUB"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FullJourneyDto"
                },
                "example": {
                  "id": 488213,
                  "code": "TZ7K4QM-1",
                  "pickup": {
                    "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"
                  },
                  "dropoff": {
                    "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
                  },
                  "pickupTime": {
                    "localTime": "2026-12-01T14:30:00",
                    "timeZone": "Europe/Amsterdam"
                  },
                  "addonsPerQuantity": [
                    {
                      "type": "MEET_GREET",
                      "amount": 1
                    }
                  ],
                  "vehicleCategory": "SEDAN",
                  "type": "HUB",
                  "distance": 19.8,
                  "distanceUnit": "KILOMETER",
                  "duration": 1560,
                  "fareSummary": {
                    "includingVat": 57,
                    "excludingVat": 52.29,
                    "vat": 4.71,
                    "currency": "EUR",
                    "geoZoneId": 801,
                    "operationZoneId": 912
                  },
                  "status": "CONFIRMED",
                  "meetingPoint": {
                    "id": 2561,
                    "title": "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.",
                    "latitude": 52.3094,
                    "longitude": 4.7622,
                    "type": "HUB"
                  },
                  "driverCode": "D7K4QM",
                  "assignmentStatus": "NOT_ASSIGNED",
                  "travellerInfo": {
                    "firstName": "Alex",
                    "lastName": "Traveller",
                    "email": "alex.traveller@example.com",
                    "phone": "+447700900123",
                    "meetAndGreetSignText": "Alex Traveller",
                    "passengerCount": 2,
                    "adultPassengerCount": 2,
                    "childPassengerCount": 0,
                    "infantPassengerCount": 0,
                    "luggageCount": 3,
                    "checkedLuggageCount": 2,
                    "carryOnLuggageCount": 1,
                    "driverComments": "Two suitcases and a stroller.",
                    "flightNumber": "TZ1234",
                    "trainNumber": null,
                    "shipName": null,
                    "language": "en"
                  },
                  "partnerReference": "ORDER-10023",
                  "driver": null,
                  "lastKnownDriverPosition": null,
                  "vehicle": null,
                  "hostTravellerMetTime": null,
                  "hostTravellerMetPosition": null,
                  "hash": "9f2c41d07ab3e6f5"
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    },
    "/actions": {
      "get": {
        "tags": [
          "Actions"
        ],
        "summary": "Search actions",
        "description": "Retrieves the actions for the given search parameters",
        "operationId": "search",
        "parameters": [
          {
            "name": "journeyId",
            "in": "query",
            "description": "The journey ID for which to find the actions",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer",
              "default": 0
            }
          },
          {
            "name": "size",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer",
              "default": 10
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Format: (property;direction). Direction - asc,desc. Multiple sort criteria are supported.",
            "required": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "id;asc",
                  "id;desc",
                  "created;asc",
                  "created;desc"
                ]
              }
            }
          },
          {
            "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/PagedResultsDtoActionDto"
                },
                "example": {
                  "pagination": {
                    "currentPage": 0,
                    "pageSize": 10,
                    "totalPages": 1,
                    "totalResults": 1
                  },
                  "results": [
                    {
                      "id": 140022,
                      "journeyId": 488213,
                      "created": "2026-12-01T15:32:10",
                      "updated": "2026-12-01T15:33:02",
                      "type": "TRAVELLER_NO_SHOW",
                      "attachmentFileIds": [
                        99331
                      ]
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      },
      "post": {
        "tags": [
          "Actions"
        ],
        "summary": "Create action",
        "description": "Creates action for specified journey",
        "operationId": "create",
        "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/CreateActionRequestDto"
              },
              "example": {
                "journeyId": 488213,
                "type": "TRAVELLER_NO_SHOW",
                "position": {
                  "lat": 52.3094,
                  "lng": 4.7622
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ActionDto"
                },
                "example": {
                  "id": 140022,
                  "journeyId": 488213,
                  "created": "2026-12-01T15:32:10",
                  "updated": "2026-12-01T15:32:10",
                  "type": "TRAVELLER_NO_SHOW",
                  "attachmentFileIds": []
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    },
    "/actions/{actionId}/photo": {
      "post": {
        "tags": [
          "Actions"
        ],
        "summary": "Upload attachment",
        "description": "Handles multipart file request data for the provided action id",
        "operationId": "uploadAttachment",
        "parameters": [
          {
            "name": "actionId",
            "in": "path",
            "description": "The id of the action to upload data for",
            "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": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The photo attachment file"
                  }
                },
                "required": [
                  "file"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    },
    "/operation-zones/{id}": {
      "get": {
        "tags": [
          "Zones"
        ],
        "summary": "Get operation zone",
        "description": "Retrieves an operation zone by its identifier",
        "operationId": "getOperationZoneById",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "The id of the operation zone 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/OperationZoneResponseDto"
                },
                "example": {
                  "id": 912,
                  "name": "Schiphol – Amsterdam region",
                  "polygon": [
                    {
                      "lat": 52.4302,
                      "lng": 4.7289
                    },
                    {
                      "lat": 52.4302,
                      "lng": 5.0684
                    },
                    {
                      "lat": 52.2785,
                      "lng": 5.0684
                    },
                    {
                      "lat": 52.2785,
                      "lng": 4.7289
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    },
    "/offers/{id}": {
      "get": {
        "tags": [
          "Offers"
        ],
        "summary": "Get offer",
        "description": "Retrieves a specific offer by id",
        "operationId": "getOfferById",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "The id of the offer 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/OfferDto"
                },
                "example": {
                  "id": 6120044,
                  "preferred": true,
                  "fleet": {
                    "fleetId": 3301,
                    "fleetName": "Amsterdam airport fleet",
                    "transferCompanyId": 2290,
                    "transferCompanyName": "Canal City Transfers"
                  },
                  "journey": {
                    "id": 488213,
                    "code": "TZ7K4QM-1",
                    "pickup": {
                      "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"
                    },
                    "dropoff": {
                      "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
                    },
                    "pickupTime": {
                      "localTime": "2026-12-01T14:30:00",
                      "timeZone": "Europe/Amsterdam"
                    },
                    "addonsPerQuantity": [
                      {
                        "type": "MEET_GREET",
                        "amount": 1
                      }
                    ],
                    "vehicleCategory": "SEDAN",
                    "distance": 19.8,
                    "distanceUnit": "KILOMETER",
                    "duration": 1560,
                    "fareSummary": {
                      "includingVat": 57,
                      "excludingVat": 52.29,
                      "vat": 4.71,
                      "currency": "EUR",
                      "geoZoneId": 801,
                      "operationZoneId": 912
                    },
                    "travellerInfo": {
                      "firstName": null,
                      "lastName": null,
                      "email": null,
                      "phone": null,
                      "meetAndGreetSignText": null,
                      "passengerCount": 2,
                      "adultPassengerCount": 2,
                      "childPassengerCount": 0,
                      "infantPassengerCount": 0,
                      "luggageCount": 3,
                      "checkedLuggageCount": 2,
                      "carryOnLuggageCount": 1,
                      "driverComments": "Two suitcases and a stroller.",
                      "flightNumber": "TZ1234",
                      "trainNumber": null,
                      "shipName": null,
                      "language": "en"
                    }
                  },
                  "meetingPoints": [
                    {
                      "id": 2561,
                      "title": "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.",
                      "latitude": 52.3094,
                      "longitude": 4.7622,
                      "type": "HUB"
                    }
                  ],
                  "addonsPerQuantity": [
                    {
                      "type": "MEET_GREET",
                      "amount": 1
                    }
                  ],
                  "meetingPointRequired": true,
                  "expiry": "2026-11-20T12:47:00",
                  "status": "NOTIFIED",
                  "replacement": false
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    },
    "/offers/available/all": {
      "get": {
        "tags": [
          "Offers"
        ],
        "summary": "Get available offers",
        "description": "Retrieves all available offers for the provided credentials",
        "operationId": "getAvailableOffers",
        "parameters": [
          {
            "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/OfferDto"
                  }
                },
                "example": [
                  {
                    "id": 6120044,
                    "preferred": true,
                    "fleet": {
                      "fleetId": 3301,
                      "fleetName": "Amsterdam airport fleet",
                      "transferCompanyId": 2290,
                      "transferCompanyName": "Canal City Transfers"
                    },
                    "journey": {
                      "id": 488213,
                      "code": "TZ7K4QM-1",
                      "pickup": {
                        "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"
                      },
                      "dropoff": {
                        "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
                      },
                      "pickupTime": {
                        "localTime": "2026-12-01T14:30:00",
                        "timeZone": "Europe/Amsterdam"
                      },
                      "addonsPerQuantity": [
                        {
                          "type": "MEET_GREET",
                          "amount": 1
                        }
                      ],
                      "vehicleCategory": "SEDAN",
                      "distance": 19.8,
                      "distanceUnit": "KILOMETER",
                      "duration": 1560,
                      "fareSummary": {
                        "includingVat": 57,
                        "excludingVat": 52.29,
                        "vat": 4.71,
                        "currency": "EUR",
                        "geoZoneId": 801,
                        "operationZoneId": 912
                      },
                      "travellerInfo": {
                        "firstName": null,
                        "lastName": null,
                        "email": null,
                        "phone": null,
                        "meetAndGreetSignText": null,
                        "passengerCount": 2,
                        "adultPassengerCount": 2,
                        "childPassengerCount": 0,
                        "infantPassengerCount": 0,
                        "luggageCount": 3,
                        "checkedLuggageCount": 2,
                        "carryOnLuggageCount": 1,
                        "driverComments": "Two suitcases and a stroller.",
                        "flightNumber": "TZ1234",
                        "trainNumber": null,
                        "shipName": null,
                        "language": "en"
                      }
                    },
                    "meetingPoints": [
                      {
                        "id": 2561,
                        "title": "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.",
                        "latitude": 52.3094,
                        "longitude": 4.7622,
                        "type": "HUB"
                      }
                    ],
                    "addonsPerQuantity": [
                      {
                        "type": "MEET_GREET",
                        "amount": 1
                      }
                    ],
                    "meetingPointRequired": true,
                    "expiry": "2026-11-20T12:47:00",
                    "status": "NOTIFIED",
                    "replacement": false
                  }
                ]
              }
            }
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    },
    "/journeys": {
      "get": {
        "tags": [
          "Journeys"
        ],
        "summary": "Search journeys",
        "description": "Retrieves a list of journeys based on the provided parameters for which an offer has been accepted",
        "operationId": "searchJourneys",
        "parameters": [
          {
            "name": "journeyId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "bookingId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "bookingCode",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "journeyCode",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "driverCode",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "pickupDateAfter",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "pickupDateBefore",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "assignedTransferCompanyId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "integer",
                "format": "int64"
              },
              "uniqueItems": true
            }
          },
          {
            "name": "assignedFleetId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "integer",
                "format": "int64"
              },
              "uniqueItems": true
            }
          },
          {
            "name": "updatedBefore",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "updatedAfter",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "createdBefore",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "createdAfter",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "includedStatuses",
            "in": "query",
            "required": false,
            "schema": {
              "type": "array",
              "items": {
                "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"
                ]
              },
              "uniqueItems": true
            }
          },
          {
            "name": "excludedStatuses",
            "in": "query",
            "required": false,
            "schema": {
              "type": "array",
              "items": {
                "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"
                ]
              },
              "uniqueItems": true
            }
          },
          {
            "name": "completedOnAfter",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "completedOnBefore",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "cancelledAfter",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "cancelledBefore",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "travellerEmailAddress",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "travellerName",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "heldForComplaint",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "hubCountry",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer",
              "default": 0
            }
          },
          {
            "name": "size",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer",
              "default": 10
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Format: (property;direction). Direction - asc,desc. Multiple sort criteria are supported.",
            "required": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "id;asc",
                  "id;desc",
                  "pickup;asc",
                  "pickup;desc",
                  "created;asc",
                  "created;desc",
                  "status;asc",
                  "status;desc"
                ]
              }
            }
          },
          {
            "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/PagedResultsDtoFullJourneyDto"
                },
                "example": {
                  "pagination": {
                    "currentPage": 0,
                    "pageSize": 20,
                    "totalPages": 1,
                    "totalResults": 1
                  },
                  "results": [
                    {
                      "id": 488213,
                      "code": "TZ7K4QM-1",
                      "pickup": {
                        "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"
                      },
                      "dropoff": {
                        "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
                      },
                      "pickupTime": {
                        "localTime": "2026-12-01T14:30:00",
                        "timeZone": "Europe/Amsterdam"
                      },
                      "addonsPerQuantity": [
                        {
                          "type": "MEET_GREET",
                          "amount": 1
                        }
                      ],
                      "vehicleCategory": "SEDAN",
                      "type": "HUB",
                      "distance": 19.8,
                      "distanceUnit": "KILOMETER",
                      "duration": 1560,
                      "fareSummary": {
                        "includingVat": 57,
                        "excludingVat": 52.29,
                        "vat": 4.71,
                        "currency": "EUR",
                        "geoZoneId": 801,
                        "operationZoneId": 912
                      },
                      "status": "PLANNED",
                      "meetingPoint": {
                        "id": 2561,
                        "title": "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.",
                        "latitude": 52.3094,
                        "longitude": 4.7622,
                        "type": "HUB"
                      },
                      "driverCode": "D7K4QM",
                      "assignmentStatus": "ASSIGNED",
                      "travellerInfo": {
                        "firstName": "Alex",
                        "lastName": "Traveller",
                        "email": "alex.traveller@example.com",
                        "phone": "+447700900123",
                        "meetAndGreetSignText": "Alex Traveller",
                        "passengerCount": 2,
                        "adultPassengerCount": 2,
                        "childPassengerCount": 0,
                        "infantPassengerCount": 0,
                        "luggageCount": 3,
                        "checkedLuggageCount": 2,
                        "carryOnLuggageCount": 1,
                        "driverComments": "Two suitcases and a stroller.",
                        "flightNumber": "TZ1234",
                        "trainNumber": null,
                        "shipName": null,
                        "language": "en"
                      },
                      "partnerReference": "ORDER-10023",
                      "driver": {
                        "id": 77015,
                        "name": "Jordan Driver",
                        "phoneNumber": "+447700900456"
                      },
                      "lastKnownDriverPosition": {
                        "latitude": 52.3091,
                        "longitude": 4.7624,
                        "recordedAt": "2026-12-01T13:12:05"
                      },
                      "vehicle": {
                        "id": 88120,
                        "licensePlate": "TZ-123-X",
                        "makeName": "Toyota",
                        "modelName": "Corolla Touring",
                        "seriesName": "Hybrid"
                      },
                      "hostTravellerMetTime": null,
                      "hostTravellerMetPosition": null,
                      "hash": "9f2c41d07ab3e6f5"
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    },
    "/journeys/{id}": {
      "get": {
        "tags": [
          "Journeys"
        ],
        "summary": "Get journey",
        "description": "Retrieves a specific journey by id",
        "operationId": "getJourneyById",
        "parameters": [
          {
            "name": "id",
            "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/FullJourneyDto"
                },
                "example": {
                  "id": 488213,
                  "code": "TZ7K4QM-1",
                  "pickup": {
                    "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"
                  },
                  "dropoff": {
                    "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
                  },
                  "pickupTime": {
                    "localTime": "2026-12-01T14:30:00",
                    "timeZone": "Europe/Amsterdam"
                  },
                  "addonsPerQuantity": [
                    {
                      "type": "MEET_GREET",
                      "amount": 1
                    }
                  ],
                  "vehicleCategory": "SEDAN",
                  "type": "HUB",
                  "distance": 19.8,
                  "distanceUnit": "KILOMETER",
                  "duration": 1560,
                  "fareSummary": {
                    "includingVat": 57,
                    "excludingVat": 52.29,
                    "vat": 4.71,
                    "currency": "EUR",
                    "geoZoneId": 801,
                    "operationZoneId": 912
                  },
                  "status": "CONFIRMED",
                  "meetingPoint": {
                    "id": 2561,
                    "title": "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.",
                    "latitude": 52.3094,
                    "longitude": 4.7622,
                    "type": "HUB"
                  },
                  "driverCode": "D7K4QM",
                  "assignmentStatus": "NOT_ASSIGNED",
                  "travellerInfo": {
                    "firstName": "Alex",
                    "lastName": "Traveller",
                    "email": "alex.traveller@example.com",
                    "phone": "+447700900123",
                    "meetAndGreetSignText": "Alex Traveller",
                    "passengerCount": 2,
                    "adultPassengerCount": 2,
                    "childPassengerCount": 0,
                    "infantPassengerCount": 0,
                    "luggageCount": 3,
                    "checkedLuggageCount": 2,
                    "carryOnLuggageCount": 1,
                    "driverComments": "Two suitcases and a stroller.",
                    "flightNumber": "TZ1234",
                    "trainNumber": null,
                    "shipName": null,
                    "language": "en"
                  },
                  "partnerReference": "ORDER-10023",
                  "driver": null,
                  "lastKnownDriverPosition": null,
                  "vehicle": null,
                  "hostTravellerMetTime": null,
                  "hostTravellerMetPosition": null,
                  "hash": "9f2c41d07ab3e6f5"
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    },
    "/geo-zones/{id}": {
      "get": {
        "tags": [
          "Zones"
        ],
        "summary": "Get geo zone",
        "description": "Retrieves a geo zone by its identifier",
        "operationId": "getGeoZoneById",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "The id of the geo zone 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/GeoZoneResponseDto"
                },
                "example": {
                  "id": 801,
                  "name": "Amsterdam city centre",
                  "polygon": [
                    {
                      "lat": 52.4302,
                      "lng": 4.7289
                    },
                    {
                      "lat": 52.4302,
                      "lng": 5.0684
                    },
                    {
                      "lat": 52.2785,
                      "lng": 5.0684
                    },
                    {
                      "lat": 52.2785,
                      "lng": 4.7289
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKeyScheme": []
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "DriverPositionDto": {
        "type": "object",
        "properties": {
          "latitude": {
            "type": "number",
            "format": "double"
          },
          "longitude": {
            "type": "number",
            "format": "double"
          },
          "recordedAt": {
            "type": "string",
            "format": "date-time",
            "description": "The moment the event occurred, in UTC. Defaults to the time of the request when omitted.",
            "example": "2026-02-20T06:10:04.639"
          }
        },
        "required": [
          "latitude",
          "longitude"
        ]
      },
      "PickupInfoDto": {
        "type": "object",
        "properties": {
          "pickupTime": {
            "type": "string",
            "format": "date-time"
          },
          "pickupLocation": {
            "$ref": "#/components/schemas/PickupLocationDto"
          }
        }
      },
      "PickupLocationDto": {
        "type": "object",
        "properties": {
          "description": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "latitude": {
            "type": "number",
            "format": "double",
            "maximum": 90,
            "minimum": -90
          },
          "longitude": {
            "type": "number",
            "format": "double",
            "maximum": 180,
            "minimum": -180
          }
        },
        "required": [
          "description",
          "latitude",
          "longitude"
        ]
      },
      "HostTravellerMetDto": {
        "type": "object",
        "properties": {
          "latitude": {
            "type": "number",
            "format": "double",
            "description": "The latitude where the host met the traveller",
            "example": 52.3105
          },
          "longitude": {
            "type": "number",
            "format": "double",
            "description": "The longitude where the host met the traveller",
            "example": 4.7683
          },
          "recordedAt": {
            "type": "string",
            "format": "date-time",
            "description": "The moment the event occurred, in UTC. Defaults to the time of the request when omitted.",
            "example": "2026-02-20T06:10:04.639"
          }
        }
      },
      "AssignVehicleRequestDto": {
        "type": "object",
        "properties": {
          "licensePlate": {
            "type": "string",
            "minLength": 1
          },
          "model": {
            "type": "string"
          },
          "make": {
            "type": "string"
          },
          "series": {
            "type": "string"
          },
          "reassign": {
            "type": "boolean"
          }
        },
        "required": [
          "licensePlate"
        ]
      },
      "AssignDriverRequestDto": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "phoneNumber": {
            "type": "string",
            "pattern": "^\\+(?:[0-9]?){6,14}[0-9]$"
          },
          "notifyBySms": {
            "type": "boolean"
          },
          "reassign": {
            "type": "boolean"
          }
        },
        "required": [
          "name",
          "phoneNumber"
        ]
      },
      "DeclineOfferDto": {
        "type": "object",
        "properties": {
          "reason": {
            "type": "string",
            "enum": [
              "FARE_TOO_LOW",
              "NO_VEHICLE_AVAILABILITY",
              "NO_DRIVER_AVAILABILITY",
              "ADDONS_NOT_AVAILABLE",
              "INCORRECT_JOURNEY_DETAILS",
              "HOLIDAY",
              "STRIKE",
              "DISTANCE_TOO_SHORT_OR_LONG",
              "OTHER"
            ]
          },
          "description": {
            "type": "string"
          }
        },
        "required": [
          "reason"
        ]
      },
      "AcceptOfferDto": {
        "type": "object",
        "properties": {
          "meetingPointId": {
            "type": "integer",
            "format": "int64"
          },
          "type": {
            "type": "string",
            "enum": [
              "HUB",
              "TRANSFER_COMPANY"
            ]
          }
        }
      },
      "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"
          }
        }
      },
      "DriverDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "name": {
            "type": "string"
          },
          "phoneNumber": {
            "type": "string"
          }
        }
      },
      "FareSummaryResponseDto": {
        "type": "object",
        "properties": {
          "includingVat": {
            "type": "number"
          },
          "excludingVat": {
            "type": "number"
          },
          "vat": {
            "type": "number"
          },
          "currency": {
            "type": "string"
          },
          "geoZoneId": {
            "type": "integer",
            "format": "int64"
          },
          "operationZoneId": {
            "type": "integer",
            "format": "int64"
          }
        }
      },
      "FullJourneyDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "code": {
            "type": "string"
          },
          "pickup": {
            "$ref": "#/components/schemas/LocationDto"
          },
          "dropoff": {
            "$ref": "#/components/schemas/LocationDto"
          },
          "pickupTime": {
            "$ref": "#/components/schemas/PickupDto"
          },
          "addOns": {
            "type": "array",
            "deprecated": true,
            "items": {
              "type": "string",
              "deprecated": true,
              "enum": [
                "MEET_GREET",
                "BABY_SEAT",
                "BOOSTER_SEAT",
                "PETS",
                "EXTRA_STOP",
                "SPECIAL_LUGGAGE",
                "CARBON_EMISSION_COMPENSATION",
                "CHILD_SEAT"
              ]
            }
          },
          "addonsPerQuantity": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TravelAddonDto"
            }
          },
          "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"
            ]
          },
          "type": {
            "type": "string",
            "enum": [
              "HUB",
              "POINT_TO_POINT"
            ]
          },
          "distance": {
            "type": "number"
          },
          "distanceUnit": {
            "type": "string",
            "enum": [
              "METER",
              "FEET",
              "KILOMETER",
              "MILE"
            ]
          },
          "duration": {
            "type": "integer",
            "format": "int32"
          },
          "fareSummary": {
            "$ref": "#/components/schemas/FareSummaryResponseDto"
          },
          "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"
            ]
          },
          "meetingPoint": {
            "$ref": "#/components/schemas/MeetingPointDto"
          },
          "driverCode": {
            "type": "string"
          },
          "assignmentStatus": {
            "type": "string",
            "enum": [
              "NOT_ASSIGNED",
              "ASSIGNED",
              "REASSIGNED"
            ]
          },
          "travellerInfo": {
            "$ref": "#/components/schemas/TravellerInfoDto"
          },
          "partnerReference": {
            "type": "string"
          },
          "driver": {
            "$ref": "#/components/schemas/DriverDto"
          },
          "lastKnownDriverPosition": {
            "$ref": "#/components/schemas/DriverPositionDto"
          },
          "vehicle": {
            "$ref": "#/components/schemas/VehicleDto"
          },
          "hostTravellerMetTime": {
            "type": "string",
            "format": "date-time"
          },
          "hostTravellerMetPosition": {
            "$ref": "#/components/schemas/GeoPositionDto"
          },
          "hash": {
            "type": "string"
          }
        }
      },
      "GeoPositionDto": {
        "type": "object",
        "properties": {
          "latitude": {
            "type": "number",
            "format": "double",
            "description": "Latitude of the position",
            "example": 52.3105
          },
          "longitude": {
            "type": "number",
            "format": "double",
            "description": "Longitude of the position",
            "example": 4.7683
          }
        }
      },
      "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"
          }
        }
      },
      "MeetingPointDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "title": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "latitude": {
            "type": "number",
            "format": "double"
          },
          "longitude": {
            "type": "number",
            "format": "double"
          },
          "type": {
            "type": "string",
            "enum": [
              "HUB",
              "TRANSFER_COMPANY"
            ]
          }
        }
      },
      "PickupDto": {
        "type": "object",
        "properties": {
          "localTime": {
            "type": "string",
            "format": "date-time"
          },
          "timeZone": {
            "type": "string"
          }
        }
      },
      "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"
          }
        }
      },
      "TravellerInfoDto": {
        "type": "object",
        "properties": {
          "firstName": {
            "type": "string"
          },
          "lastName": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "phone": {
            "type": "string"
          },
          "meetAndGreetSignText": {
            "type": "string"
          },
          "passengerCount": {
            "type": "integer",
            "format": "int32"
          },
          "adultPassengerCount": {
            "type": "integer",
            "format": "int32"
          },
          "childPassengerCount": {
            "type": "integer",
            "format": "int32"
          },
          "infantPassengerCount": {
            "type": "integer",
            "format": "int32"
          },
          "luggageCount": {
            "type": "number"
          },
          "checkedLuggageCount": {
            "type": "integer",
            "format": "int32"
          },
          "carryOnLuggageCount": {
            "type": "integer",
            "format": "int32"
          },
          "driverComments": {
            "type": "string"
          },
          "flightNumber": {
            "type": "string"
          },
          "trainNumber": {
            "type": "string"
          },
          "shipName": {
            "type": "string"
          },
          "language": {
            "type": "string"
          }
        }
      },
      "VehicleDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "licensePlate": {
            "type": "string"
          },
          "makeName": {
            "type": "string"
          },
          "modelName": {
            "type": "string"
          },
          "seriesName": {
            "type": "string"
          }
        }
      },
      "CreateActionPositionDto": {
        "type": "object",
        "properties": {
          "lat": {
            "type": "number",
            "format": "double"
          },
          "lng": {
            "type": "number",
            "format": "double"
          }
        },
        "required": [
          "lat",
          "lng"
        ]
      },
      "CreateActionRequestDto": {
        "type": "object",
        "properties": {
          "journeyId": {
            "type": "integer",
            "format": "int64"
          },
          "type": {
            "type": "string",
            "enum": [
              "DRIVER_DELAYED",
              "TRAVELLER_NO_SHOW",
              "ADDITIONAL_PROOF_TRAVELLER_NO_SHOW",
              "DRIVER_LEFT_PICKUP"
            ]
          },
          "position": {
            "$ref": "#/components/schemas/CreateActionPositionDto"
          }
        }
      },
      "ActionDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "journeyId": {
            "type": "integer",
            "format": "int64"
          },
          "created": {
            "type": "string",
            "format": "date-time"
          },
          "updated": {
            "type": "string",
            "format": "date-time"
          },
          "type": {
            "type": "string",
            "enum": [
              "DRIVER_DELAYED",
              "TRAVELLER_NO_SHOW",
              "ADDITIONAL_PROOF_TRAVELLER_NO_SHOW",
              "DRIVER_LEFT_PICKUP"
            ]
          },
          "attachmentFileIds": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int64"
            },
            "uniqueItems": true
          }
        }
      },
      "CoordinateDto": {
        "type": "object",
        "properties": {
          "lat": {
            "type": "number",
            "format": "double"
          },
          "lng": {
            "type": "number",
            "format": "double"
          }
        }
      },
      "OperationZoneResponseDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "name": {
            "type": "string"
          },
          "polygon": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CoordinateDto"
            }
          }
        }
      },
      "FleetDto": {
        "type": "object",
        "properties": {
          "fleetId": {
            "type": "integer",
            "format": "int64"
          },
          "fleetName": {
            "type": "string"
          },
          "transferCompanyId": {
            "type": "integer",
            "format": "int64"
          },
          "transferCompanyName": {
            "type": "string"
          }
        }
      },
      "LimitedJourneyDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "code": {
            "type": "string"
          },
          "pickup": {
            "$ref": "#/components/schemas/LocationDto"
          },
          "dropoff": {
            "$ref": "#/components/schemas/LocationDto"
          },
          "pickupTime": {
            "$ref": "#/components/schemas/PickupDto"
          },
          "addOns": {
            "type": "array",
            "deprecated": true,
            "items": {
              "type": "string",
              "deprecated": true,
              "enum": [
                "MEET_GREET",
                "BABY_SEAT",
                "BOOSTER_SEAT",
                "PETS",
                "EXTRA_STOP",
                "SPECIAL_LUGGAGE",
                "CARBON_EMISSION_COMPENSATION",
                "CHILD_SEAT"
              ]
            }
          },
          "addonsPerQuantity": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TravelAddonDto"
            }
          },
          "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"
            ]
          },
          "distance": {
            "type": "number"
          },
          "distanceUnit": {
            "type": "string",
            "enum": [
              "METER",
              "FEET",
              "KILOMETER",
              "MILE"
            ]
          },
          "duration": {
            "type": "integer",
            "format": "int32"
          },
          "fareSummary": {
            "$ref": "#/components/schemas/FareSummaryResponseDto"
          },
          "travellerInfo": {
            "$ref": "#/components/schemas/TravellerInfoDto"
          }
        }
      },
      "OfferDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "preferred": {
            "type": "boolean"
          },
          "fleet": {
            "$ref": "#/components/schemas/FleetDto"
          },
          "journey": {
            "$ref": "#/components/schemas/LimitedJourneyDto"
          },
          "meetingPoints": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MeetingPointDto"
            }
          },
          "addonsPerQuantity": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TravelAddonDto"
            }
          },
          "meetingPointRequired": {
            "type": "boolean"
          },
          "expiry": {
            "type": "string",
            "format": "date-time"
          },
          "status": {
            "type": "string",
            "enum": [
              "PENDING",
              "NOTIFIED",
              "SKIPPED_NOTIFICATION",
              "ACCEPTED",
              "DECLINED",
              "EXPIRED",
              "MISSED"
            ]
          },
          "replacement": {
            "type": "boolean"
          }
        }
      },
      "PagedResultsDtoFullJourneyDto": {
        "type": "object",
        "properties": {
          "pagination": {
            "$ref": "#/components/schemas/PaginationDto"
          },
          "results": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FullJourneyDto"
            }
          }
        }
      },
      "PaginationDto": {
        "type": "object",
        "properties": {
          "currentPage": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          },
          "totalPages": {
            "type": "integer",
            "format": "int32"
          },
          "totalResults": {
            "type": "integer",
            "format": "int64"
          }
        }
      },
      "GeoZoneResponseDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "name": {
            "type": "string"
          },
          "polygon": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CoordinateDto"
            }
          }
        }
      },
      "PagedResultsDtoActionDto": {
        "type": "object",
        "properties": {
          "pagination": {
            "$ref": "#/components/schemas/PaginationDto"
          },
          "results": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ActionDto"
            }
          }
        }
      }
    },
    "securitySchemes": {
      "apiKeyScheme": {
        "type": "apiKey",
        "description": "An API key",
        "name": "X-API-Key",
        "in": "header"
      }
    }
  }
}
