Marketplace Orders

Create a New Order

POST /orders/booking

Creates a booking order at Blowhorn returning an unique tracking number upon successful validation of payload passed.

Headers

Name	Type	Description
API_KEY	string	Contact Blowhorn team for API Key

200 Order created successfully.

{
  "status": "PASS",
  "message": {
    "order_number": "YT6U2O",
    "tracking_url": "https://blowhorn.com/track/YT6U2O",
    "estimated_distance": 4.5,
    "estimated_cost": 450
  }
}

400 Bad request / Validation error

{
  "status": "FAIL",
  "message": "`value` for `pickup_time` is mandatory for advanced booking"
}

401 Unauthorized / Wrong api key

{
  "status": "FAIL",
  "message": "Unauthorized / Wrong api key"
}

500 Unexpected error

{
  "status": "FAIL",
  "message": "Unexpected error"
}

Example Value | Schema

{
  "pickup_time": {
    "type": "later",
    "value": "2018-12-12T10:47:35.408907"
  },
  "pickup": {
    "name": "Home",
    "address": {
      "area": "HSR Layout",
      "city": "Bengaluru",
      "postal_code": 560095,
      "full_address": "245, 2nd Cross, HSR Layout Bengaluru"
    },
    "contact": {
      "name": "Mahadevappa",
      "mobile": 9999999999
    },
    "geopoint": {
      "lat": 12.9081357,
      "lng": 77.64760799999999
    }
  },
  "dropoff": {
    "name": "Work",
    "address": {
      "area": "BTM Layout",
      "city": "Bengaluru",
      "postal_code": 560034,
      "full_address": "245, 3rd Main, BTM Layout Bengaluru"
    },
    "contact": {
      "name": "Raj",
      "mobile": 8888888888
    },
    "geopoint": {
      "lat": 12.9165757,
      "lng": 77.61011630000007
    }
  },
  "waypoints": [
    {
      "sequence_id": "1",
      "name": "Waypoint 1",
      "address": {
        "area": "HSR Layout",
        "city": "Bengaluru",
        "postal_code": 560102,
        "full_address": "2287 16th Cross Rd Vanganahalli 1st Sector HSR Layout Bengaluru 560102"
      },
      "contact": {
        "name": "Puneet",
        "mobile": 7777777777
      },
      "geopoint": {
        "lat": 12.912442595996774,
        "lng": 77.64740069737547
      }
    }
  ],
  "items": [
    "Chair",
    "Table"
  ],
  "num_of_labours": 1,
  "vehicle_class": "Mini-Truck",
  "payment_mode": "Online",
  "price_type": "full-day"
}

Postman Collection

We have a Postman collection to make the integration quicker and easier. You can test all our APIs by importing the full API collection through the 'Run in Postman' button and running them in the Postman app.