These docs are for v1.0. Click to read the latest docs for v2.0.

Retrieve Quote List

Get the trip quotes for the given ID.
The response payload will contain a list of quotes that is asynchronously populated. It will be updated with additional records as more responses are received from our fleet partners. This should happen reasonably quickly but demand partners may have constraints on their side that cause delays. So you should poll for updates for the longest period that your service performance allows.
You could keep polling while the status is “Progressing”. After 30 seconds the status will change to “Complete”, and the quote list items will no longer be updated. The status of “Complete” might occur before 30 seconds, if the Karhoo system has received a quote from all available fleets in the area.
Each line in the quote list will contain features of the quoted vehicle. Such as the class of vehicle and its capacity (maximum number of passengers and luggage). So, if you want a feature or minimum capacity you will need to filter this list.

{
    "id": "cbf3bbaa-ed2f-11ea-a8dc-92a5149eebf0",
    "quote_items": [
        {
            "availability_id": "Y2M5NGRkMGUtOThjZS00NjNjLTlkYzQtM2ZlZDJlOTQ3ZGEyO2V4ZWN1dGl2ZQ==",
            "category_name": "Exec",
            "currency_code": "GBP",
            "fleet_description": "Robot Taxi Fleet covering the world. Example description: Local Taxi operating in London and surroundings.",
            "fleet_id": "cc94dd0e-98ce-463c-9dc4-3fed2e947da2",
            "fleet_name": "Global Taxi (Robot Fleet WWW)",
            "fleet_rating": {},
            "high_price": 2450,
            "low_price": 2450,
            "phone_number": "+448000000000",
            "pick_up_type": "DEFAULT",
            "qta_high_minutes": 2,
            "qta_low_minutes": 2,
            "quote_id": "cbf3bbaa-ed2f-11ea-a8dc-92a5149eebf0:Y2M5NGRkMGUtOThjZS00NjNjLTlkYzQtM2ZlZDJlOTQ3ZGEyO2V4ZWN1dGl2ZQ==",
            "quote_type": "METERED",
            "source": "FLEET",
            "supplier_logo_url": "https://cdn.karhoo.com/d/images/organisation-logos/39e5726a81e8a132fe31d852e35be919.png",
            "terms_conditions_url": "https://cdn.karhoo.com/d/terms/fleets/d3b42f33-fbe6-4e63-9028-3fc7a56ada0e/index.html",
            "vehicle_attributes": {
                "luggage_capacity": 2,
                "passenger_capacity": 3
            },
            "vehicle_class": "executive"
        },
      {...},
      {...}
    ],
    "status": "COMPLETED",
    "validity": 294
}
Language
Credentials
Header
Click Try It! to start a request and see the response here!