Bulk Serviceability

By entering the carrier partner ID and account code, the enterprise can get all the serviceable drop and pickup pincodes

Overview

By entering the carrier partner ID and account code, the enterprise can get all the serviceable drop and pickup pincodes

  1. The enterprise will be able to know which types of services are available for the particular pick-up and drop pincode. The enterprise 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

  2. You can use the serviceability API to trigger order creation/ order manifestation based on the API response

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

The API will give an array of all serviceable pincodes in response

Query Parameters

Field NameData TypeFieldDescriptionMax LengthExample
username stringMandatoryUsername of the enterprise100test-enterprise
keystringMandatoryUnique license key provided by Clickpost for the enterprise3600000000-0000-0000-0000-000000000000
carrier_partner_idnumMandatoryPartner ID of the desired carrier44
account_codestringMandatoryName of the account registered on Clickpost dashboard for carrier partner. Will return a 400 Bad Request response if the given account is inactive or does not exist.100Delhivery_Express_B2C

Response

meta [meta parameters]

Field NameData TypeDescriptionExample
successBooleanIndicates the success of the API requesttrue
messageStringSUCCESS in case request was successfully processed by Clickpost, else returns error message."SUCCESS"
statusHTTP CodeThe HTTP response status code of the API request200

result [result parameters]

Field NameData TypeDescriptionExample
pickup_pincodesJSON ObjectThe JSON object which contains the list of pincodes for PREPAID and COD{"PREPAID": ["380001","380015"],
"COD": ["380001","380015"]}
drop_pincodesJSON ObjectThe JSON object which contains the list of pincodes for PREPAID and COD{"PREPAID": ["380001","380015"],
"COD": ["380001","380015"]}
PREPAIDListContains the list of all the pincodes for PREPAID shipments[
"744112",
"744106",
"744105",
]
CODListContains the list of all the pincodes for COD shipments[
"744112",
"744106",
"744105",
]