Rentals


Rent chauffeur-driven AC cars on hourly packages at the best prices. Whether you’re going for a night-out with friends, multiple client meetings, a shopping trip across the city or exploring the city’s touristy spots, have a car at your disposal throughout your journey, willing to wait while you do whatever you want to.

You can choose from Mini, Prime, Lux or SUV to suit your travel requirements.


Availability


GET /v1/products

For complete information on this API have a look at Ride Availability Documentation

Example Request

GET

https://devapi.olacabs.com/v1/products?pickup_lat=12.9491416&pickup_lng=77.64298&category=rental

Example Response


{
  "hotspot_zone": {
        "is_hotpot_zone": true,
        "desc": "Choose from convenient pickup points to board your cab.",
        "default_pickup_point_id": 10881,
        "hotspot_boundary": [
            [
                12.9468154,
                77.6472151
            ],
            [
                12.9474219,
                77.6475155
            ],
            [
                12.9478192,
                77.6467001
            ]
        ],
        "pickup_points": [
            {
                "lat": 12.9509456,
                "lng": 77.6408958,
                "name": "Sunriver",
                "id": 10880
            },
            {
                "lat": 12.9506006,
                "lng": 77.6417542,
                "name": "Cherry Hills",
                "id": 10881
            }
        ]
  },
 "categories": [
        {
            "id": "rental",
            "display_name": "Rentals",
            "currency": "INR",
            "distance_unit": "kilometer",
            "time_unit": "minute",
            "eta": 1,
            "distance": "0.0",
            "ride_later_enabled": "true",
            "ride_later_allowed": true,
            "ride_now_allowed": true,
            "image": "http://d1foexe15giopy.cloudfront.net/rental.png",
            "hotspot_pickup_points": [
                  10879,
                  10880,
                  10881
            ],
            "all_cabs": [
                {
                    "lat": 12.9503519,
                    "lng": 77.6415236,
                    "bearing": 289,
                    "accuracy": 16,
                    "id": "ef79aa1e12"
                },

            ],
            "select_applicable": false,
            "sub_categories": [

                {
                    "id": "lux",
                    "display_name": "LUX",
                    "description": "Ride in luxury cars at affordable fares",
                    "car_models": [
                        "Mercedes-Benz",
                        " BMW",
                        " Audi",
                        " Accord"
                    ],
                    "highlights": [
                        "Luxury Ride",
                        "Free Wi-Fi",
                        "Top Partners"
                    ],
                    "capacity": "4",
                    "currency": "INR",
                    "distance_unit": "kilometer",
                    "time_unit": "minute",
                    "eta": -1,
                    "distance": -1,
                    "cancellation_policy": {
                        "cancellation_charge": 75,
                        "currency": "INR",
                        "cancellation_charge_applies_after_time": 5,
                        "time_unit": "minute"
                    },
                    "packages": [
                        {
                            "type": "flat_rate",
                            "package_id": "5H_100K",
                            "package_description": "5 hrs 100 km",
                            "minimum_distance": "100.0",
                            "distance_unit": "Kilometers",
                            "minimum_time": "5.0",
                            "time_unit": "Hours",
                            "base_fare": "1900.0",
                            "minimum_fare": "1900.0",
                            "cost_per_distance": "19.0",
                            "waiting_cost_per_hour": "0.0",
                            "ride_cost_per_hour": "20.0",
                            "surcharge": [],
                            "rates_higher_than_usual": false,
                            "rates_lower_than_usual": false
                        }
                    ]
                }
            ]
        }
    ]
  "ride_estimate": {}
}



Create Booking


POST /v1/bookings/create

For complete information on this API have a look at Cab Booking Documentation

Example Request

POST

https://devapi.olacabs.com/v1/bookings/create


  "body": {
    "pickup_lat": "12.949918",
    "pickup_lng": "77.641951",
    "pickup_mode": "NOW",
    "category": "rental",
    "sub_category": "mini",
    "package_id": "4H_40K"
  }

  "headers": {
    "Authorization": "Bearer b6121212f12ff12f12f1f12f1f12ff",
    "X-APP-TOKEN": "66121212f12ff12f12f1f12f1f12fc",
    "Content-Type": "application/json"
  }

Example Response


{
 "booking_id": "CRN123456789",
 "crn": "000000000",
 "driver_name": "Kirankumar R",
 "driver_number": "9999999999",
 "cab_type": "rental",
 "cab_number": "KA 01 0101",
 "car_model": "Etios",
 "car_color": "Grey",
 "eta": 2,
 "driver_lat": 12.95257,
 "driver_lng": 77.6403083,
 "share_ride_url": "https://www.olacabs.com/track/6c99j3i0d",
 "surcharge_value": "1.1X"
}



Cancel Booking


POST /v1/bookings/cancel

For complete information on this API have a look at Ride Cancel Documentation

Example Request

POST

https://devapi.olacabs.com/v1/bookings/cancel


"body":{
  "booking_id":"CRN123456789",
  "reason": "My reason is not listed"
}

"headers": {
  "Authorization": "Bearer b6121212f12ff12f12f1f12f1f12ff",
  "X-APP-TOKEN": "6a56121212f12ff12f12f1f12f1f12f8c",
  "Content-Type": "application/json"
}

Example Response


{
  "status": "SUCCESS",
  "request_type": "BOOKING_CANCEL",
  "header": "Booking Cancelled",
  "text": "Your booking with crn 000000000 has been cancelled successfully."
}

Note

  • While cancelling a ride the cancel reason should be that of the sub-category. For instance if a mini ride is being cancelled then the reason that needs to be provided should be one from the cancel reasons for mini category.
  • For tracking a rental booking have a look at Cab Ride Tracking Documentation