Drop Pincode Serviceability

By entering the drop_pincode, the enterprises can determine whether the Pincode is serviceable by any of their active carriers or not.

Overview

By entering the drop_pincode, the enterprises can determine whether the Pincode is serviceable by any of their active carriers or not

The enterprise will be able to know which types of services are available for the particular drop-up Pincode or combination of pickup or drop pincode

They can know if COD (Cash on Delivery), PREPAID (payment done in advance) or EXCHANGE (Deliver one good and take one good back to the warehouse) are serviceable or not by the carrier partner

  1. Enterprises can use the serviceability API to trigger order creation/ order manifestation based on the API response

  2. Lightweight API just to check whether the drop Pincode is serviceable or not. (If there are multiple warehouses, then pass the combination of pickup and drop pincode)

Run in Postman API Reference

Usecase

This is a standard API which applies to all MPS (Multi-Piece Shipment) and SPS (Single Piece Shipment) orders

Geography

This is a standard API which supports all shipments created and transported within

  1. India

👍

Note

Enterprise can put a check on the serviceable field which they get in the response from Clickpost

🚧

Note

If the enterprise does not pass the service_type field, then Clickpost will be assume it to FORWARD shipment

Request Payload

Mandatory Field

Field NameData TypeFieldDescriptionMax LengthExample
drop_pincodenumMandatoryThe drop pincode for which the serviceability needs to be ascertained6 char380001

optional [optional parameters]

Field NameData TypeFieldDescriptionMax LengthExample
order_typeenumOptionalThe Order type

COD or PREPAID
10"COD"
pickup_pincodestringOptionalThe pickup Pincode for which the serviceability needs to be ascertained6 char"380015"
service_typeenumOptionalThe order type for which serviceability needs to be determined.

Enter FORWARD if the shipments need to be delivered to the customer from the enterprise's warehouse.

Enter RVP if the shipment needs to picked up from the customer’s location and delivered to the enterprise’s warehouse.

Enter EXCHANGE in case of exchange order
10FORWARD

Response

meta [meta parameters]

Field NameData TypeDescriptionExample
successBooleanIndicates the success of the API requesttrue
messageStringThe message from Clickpost. In case of success, it will be "SUCCESS". In case there are no carrier partners that are servicing the pincodes it will be” Pincode not serviceable""SUCCESS"
statusHTTP CodeThe HTTP response status code of the API request200

result [result parameters]

Field NameData TypeDescriptionExample
serviceableBooleanWhether the particular drop pincode is serviceable. Note: If the enterprise has multiple warehouse, then you need to pass the pickup_pincode"380015"
CODBooleanField indicates whether Cash on Delivery is supported by the particular carrier to the particular pincodetrue
PREPAIDBooleanField indicates whether Prepaid is supported by the particular carrier to the particular pincodetrue
EXCHANGEBooleanField indicates whether Exchange is supported by the particular carrier to the particular pincodetrue
{
    "meta": {
        "success": true,
        "message": "SUCCESS",
        "status": 200
    },
    "result": {
        "serviceable": true,
        "COD": false,
        "PREPAID": true,
        "EXCHANGE": false
    }
}