Price estimation

Gett business API requires you to obtain price estimation and quote_id before requesting the order.
the response will include:

  • Price value - based on the specified route coordinates and time
  • Quote id - unique id for your estimation
  • Currency symbol
  • Tax property - if the price include/ exclude tax

📘

Quote_id

The quote id secures your estimation for 2 min and you will have to add it to the order request, in some cases, the quote invalidates.

quote invalidation:

  • The order requested after the 2 min expired
  • The order was created with different time
  • The order was created with different coordinates
  • The order was amended/edited and time or coordinates was changed

An invalid or expired quote may result in rejecting your order request

Request

NameValueDescription
URL/v1/price-estimate?businessId={{businessid}}URL for Price estimation request
businessIdUUIDCompany UUID identificator obtained from Gett in registration process
originobjectlatitude and longitude of the origin
stopsarray of objectlatitude and longitude of the stop(s)
destination objectlatitude and longitude of the destination
product_id UUIDProduct UUID identifier obtained from Get Products request
scheduled_atstringThe schedule time in ISO8601 format: yyyy-mm-ddThh:mm:ss+Z
(example: 2017-12-05T18:59:23+03:00).
If the parameter is not passed it will default to on-demand
curl --location --request POST 'https://business-api.gett.com/v1/price-estimate?businessId=<companyUUID>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "origin": {
        "lat": 51.544253,
        "lng": -0.103426
    },
    "stops": [
        {
            "lat": 51.524253,
            "lng": -0.043426
        }
    ],
    "destination": {
        "lat": 51.500725,
        "lng": -0.050549
    },
    "product_id": "df49c6e9-e15d-4e8d-af4c-80bd90d2c7d7",
    "scheduled_at": "2021-02-14T15:39:10.07+03:00"
}'

Response

NameValueDescription
quote_idUUIDUnique id for price estimation
currencystringCurrency symbol of the price
currency_codestringCurrency code of the price
price.included_taxbooleanTrue - estimated price includes taxes (additional fees are not included)
price.valuestringPrice value
tech_fee.applicablebooleanis the fee applicable for the requested estimation
tech_fee.valueintfee value, the value already included in price.value
{
    "quote_id": "9ec37c9e-038e-4971-a107-0bd9d5479618",
    "currency": "£",
    "currency_code": "GBP",
    "price": {
        "include_tax": false,
        "value": "35-39"
    },
    "tech_fee": {
        "applicable": false,
        "value": 7
    }
}

What’s Next