Serviceability

Serviceability APIs provide the serviceable Pin-codes, Hubs, Area Covered by each hub, availability of vehicles and drivers of Blowhorn.

Serviceable Pincodes

GET /pincodes/

This API lists the serviceable pincodes for the city or whether a given pincode is serviceable by Blowhorn. It will provide the information of customer hubs and city as per the requirement or just list the blowhorn micro warehouses for the pincode provided. Type the pincode

Query Parameters

Name	Type	Description
customer_hubs_only	boolean	Returns only customers hubs if true otherwise returns blowhorn micro warehouses
city	string	City for which serviceable pincodes are required.
pincode	number	Pincode for which serviceability is to be checked

Headers

Name	Type	Description
API_KEY	string	Enter the API Key

200 Returns lists of pincodes or determine whether a pincode is serviceable

[
  {
    "pincodes": [
      560037,
      560087,
      560103
    ],
    "blowhorn_hub": "Koramangala Hub"
  },
  {
    "pincodes": [
      560035,
      560085
    ],
    "blowhorn_hub": "Bellandur Hub"
  }
]

400 Malformed data or missing required parameter values

Not Serviceable

{
  "error": "blowhorn does not provide service in this city",
  "operating_cities": [
    "Bengaluru",
    "Delhi NCR",
    "Chennai",
    "Hyderabad",
    "Mumbai"
  ]
}

Conflicting Params

{
  "error": "either city or pincode is to be supplied. e.g. ?city=Bengaluru or ?pincode=560076"
}

Missing Params

{
  "error": "supply either city or pincode (not both). e.g. ?city=Bengaluru or ?pincode=560076"
}

401 Unauthorized / Wrong api key

{
  "status": "string",
  "message": "string"
}

500 Unexpected Error

{
  "status": "string",
  "message": "string"
}

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.