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

Name

Value

Description

URL

/v1/price-estimate?businessId={{businessid}}

URL for Price estimation request

businessId

UUID

Company UUID identificator obtained from Gett in registration process

origin

object

latitude and longitude of the origin

stops

array of object

latitude and longitude of the stop(s)

destination

object

latitude and longitude of the destination

product_id

UUID

Product UUID identifier obtained from Get Products request

scheduled_at

string

The 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

Name

Value

Description

quote_id

UUID

Unique id for price estimation

currency

string

Currency symbol of the price

currency_code

string

Currency code of the price

price.included_tax

boolean

True - estimated price includes taxes (additional fees are not included)

price.value

string

Price value

tech_fee.applicable

boolean

is the fee applicable for the requested estimation

tech_fee.value

int

fee 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
Did this page help you?