Fetch shipment security key

Fetch shipment security key API gives the unique security key for each shipment that the enterprise can consume and store corresponding to a shipment in the system and can pass this key in the tracking page parameters to ensure higher security

Overview

  1. Fetch shipment security key API gives the security key for each shipment that you can consume and store corresponding to a shipment in the system.
  2. This security key is useful if you have the security feature enabled on Clickpost's tracking page. If the security feature is enabled on your Clickpost tracking page, you need to ensure you consume the shipment security key and pass it in URL param key while rendering the tracking page at your end.

With the security feature enabled, if you do not pass the security key in the tracking page URL for each shipment, the tracking page will not work as expected.

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
  2. North America
  3. Europe
  4. Middle East
  5. South East Asia

Query Parameters

Field NameData TypeFieldDescriptionMax LengthExample
keystringMandatoryUnique license key provided by Clickpost for the enterprise00000000-0000-0000-0000-000000000000
waybillstringMandatoryThe Air Way bill number19025410024064
cp_idnumMandatoryThe carrier partner ID

Refer to the list
4

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 that there are no carrier partners that are servicing the pincodes it will be”Pin code not serviceable""SUCCESS"
statusHTTP CodeThe HTTP response status code of the API request200

result [result parameters]

Field NameData TypeDescriptionExample
waybillstringThe airway bill number of the shipment for which the security key needs to be fetched19025410024064
cp_idnumThe carrier partner ID4
security_keystringThe security key"c020a025-9511-4a46-b1bd-31e87ad64c65"
reference_numberstringThe unique reference number of the API response"CR61622155"

API Response

{
    "meta": {
        "status": 200,
        "message": "Success",
        "success": true
    },
    "result": {
        "waybill": "19025410024065",
        "cp_id": 4,
        "security_key": "c020a025-9511-4a46-b1bd-31e87ad64c65",
        "reference_number": "CR61622155"
    }
}