--- title: "Creates a Booking Quote." method: POST path: "/v1/quotes" tags: ["Booking Quotes"] --- # Creates a Booking Quote. `POST /v1/quotes` Requests to this endpoint should reply as quickly as possible as the results are being awaited by our customers. Requests that fail may be retried after a few minutes. See more in the Responses section. ## Request body - QuoteRequest — Encapsulates the necessary information to request a Quote for one or more Transfers. - `transfers` QuoteTransferRequest[], required — The list of Transfers to be priced. - `origin` DetailedLocation, required — Represents a Location. Differs from the Booking `Location` type in that it contains `addressParts` when `type` is `Resort` and also that you can trust the `latitude` and `longitude` values. - `name` string, nullable — The internationally known English name. - `translatedName` string, nullable — The translated name when the supplier's language is not English. - `type` 'Gateway' | 'Resort', required — `Gateway` denotes Airports, Ports, and Train Stations while `Resort` denotes Cities, Neighborhoods, Regions etc. - `id` string, nullable — The Suntransfers' internal unique identifier for the Location. - `countryCode` string, required — The two-letter ISO 3166-1 country code. - `gatewayCode` string, nullable — The gateway code when `type` is `Gateway`. This is an IATA airport code for airports, a UN/LOCODE for ports, or a locally recognized code for train stations (e.g., `ESBCNSAN` for Barcelona Sants train station). - `latitude` number, double, required — The approximate Latitude. - `longitude` number, double, required — The approximate Longitude. - `addressParts` string[], nullable — The distinct components of the Address when `type` is `Resort`. - `destination` DetailedLocation, required — Represents a Location. Differs from the Booking `Location` type in that it contains `addressParts` when `type` is `Resort` and also that you can trust the `latitude` and `longitude` values. - `name` string, nullable — The internationally known English name. - `translatedName` string, nullable — The translated name when the supplier's language is not English. - `type` 'Gateway' | 'Resort', required — `Gateway` denotes Airports, Ports, and Train Stations while `Resort` denotes Cities, Neighborhoods, Regions etc. - `id` string, nullable — The Suntransfers' internal unique identifier for the Location. - `countryCode` string, required — The two-letter ISO 3166-1 country code. - `gatewayCode` string, nullable — The gateway code when `type` is `Gateway`. This is an IATA airport code for airports, a UN/LOCODE for ports, or a locally recognized code for train stations (e.g., `ESBCNSAN` for Barcelona Sants train station). - `latitude` number, double, required — The approximate Latitude. - `longitude` number, double, required — The approximate Longitude. - `addressParts` string[], nullable — The distinct components of the Address when `type` is `Resort`. - `vehicle` QuoteVehicle, required — Details about a Vehicle required for a Transfer. - `code` string, required — The Suntransfers Vehicle Code. - `type` string, required — The type of the Vehicle. - `title` string, required — The title of the Vehicle. - `isShared` boolean, required — Indicates if the Vehicle is of shared type (e.g., shuttle) or private type (e.g., taxi). - `isWheelchairAccessible` boolean, required — Indicates if the Vehicle is wheelchair accessible. - `maxPassengers` integer, nullable — The maximum number of Passengers the Vehicle can accommodate. This property is `null` for shuttle-type Vehicles where the capacity is virtually unlimited. - `passengers` QuotePassengers, required — The specifics about the number of Passengers in the Transfer. - `total` integer, required — The total number of Passengers in the Transfer, that is, the sum of `adults`, `children`, and `infants`. - `adults` integer, required — The number of adults in the Transfer. - `children` integer, required — The number of children in the Transfer. - `infants` integer, required — The number of infants in the Transfer. - `ages` integer[], nullable — The ages, in years, of the children and infants in the Transfer. - `transferDateTime` string, date-time, required — An ISO 8601 date-time string in local time. - `extras` QuoteExtra[], nullable — Extra services for the Transfer. - `id` string, required — The Suntransfers Extra identifier. - `name` string, required — The name of the Extra. - `translatedName` string, required — The translated name of the Extra. - `quantity` integer, required — The quantity of the Extra. - `unitRate` number, double, required — The unit rate of the Extra. - `notes` string, nullable — Additional notes about the Extra. ## Response `201` `201 Created`: The Booking Quote has been created. Signals that the Quote or Quotes returned can be used later for creating a Booking with the same settings. - QuoteResponse — Represents the result of a Quote request. - `transfers` QuoteTransferResponse[], required — The list of Transfers for the requested Quotes. - `quotes` TransferQuote[], required — The list of available Quotes for a Transfer. - `id` string, required — An identifier of the Quote that can be used later to create a Booking under the same settings. - `vehicle` QuoteVehicle, required — Details about a Vehicle required for a Transfer. - `code` string, required — The Suntransfers Vehicle Code. - `type` string, required — The type of the Vehicle. - `title` string, required — The title of the Vehicle. - `isShared` boolean, required — Indicates if the Vehicle is of shared type (e.g., shuttle) or private type (e.g., taxi). - `isWheelchairAccessible` boolean, required — Indicates if the Vehicle is wheelchair accessible. - `maxPassengers` integer, nullable — The maximum number of Passengers the Vehicle can accommodate. This property is `null` for shuttle-type Vehicles where the capacity is virtually unlimited. - `validUntilUtc` string, date-time, required — An ISO 8601 date-time string in UTC. - `price` QuoteTransferPrice, required — The pricing details of a Transfer. - `baseRate` number, double, required — The base rate for the Transfer. - `extras` number, double, nullable — The total amount for any extra services added to the Transfer. - `nightSupplement` number, double, nullable — The additional charge for night Transfers. - `weekdaySupplement` number, double, nullable — The additional charge for weekday Transfers. - `totalRate` number, double, required — The total rate for the Transfer, that is, the sum of `baseRate`, `extras`, `nightSupplement`, and `weekdaySupplement`. - `subSupplierName` string, nullable — The name of the Sub-Supplier providing the Transfer. - `extras` QuoteExtra[], nullable — The list of Extra services added to the Transfer. - `id` string, required — The Suntransfers Extra identifier. - `name` string, required — The name of the Extra. - `translatedName` string, required — The translated name of the Extra. - `quantity` integer, required — The quantity of the Extra. - `unitRate` number, double, required — The unit rate of the Extra. - `notes` string, nullable — Additional notes about the Extra. ## Other responses - `400` — `400 Bad Request`: The details of the issues found on the request are present in the `detail` property of the response. - `401` — `401 Unauthorized`: Credentials are likely out of sync. Contact Suntransfers as soon as possible via our official email to synchronize credentials. Attention: DO NOT specify any details about username, password, or authentication method in the response. - `500` — `500 Internal Server Error`: Suntransfers systems might retry this request later. - `501` — `501 Not Implemented`: This operation is not supported by the API. --- [API](https://skmtc.net/suntransfers/apis/st-spec-suntransfers-supplier-api-specification.md) · [All operations](https://skmtc.net/suntransfers/apis/st-spec-suntransfers-supplier-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/suntransfers/st-spec-suntransfers-supplier-api-specification/revisions/af3b2f961b6a/schema)