Returns Polling Delta API

The Return Polling Delta API is used to fetch all the return requests raised in the Clickpost system in a 60 minute window. This can be considered as a fallback mechanism to the Return Request Received Webhook mentioned above that is already in place to share this data.

Overview

The Return Polling Delta API is used to fetch all the return requests raised in the Clickpost system in a 60-minute window.

This can be considered as a fallback mechanism to the Return Request Received Webhook mentioned above that is already in place to share this data.

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

❗

NOTE

The difference between Start Time and End Time cannot be more that 60 minutes.

Query Parameters

Query Parameters to be passed directly in the URL.

Field NameData TypeFieldDescriptionMax LengthExample
keyStringMandatoryUnique license key100Provided by Clickpost team
user_nameStringMandatoryUsername100Provided by Clickpost team
start_timeTimestampMandatoryStart time for which the returns needs to be retrieved
YYYY-MM-DDThh:mm:ss
1002022-11-09T11:00:00
end_timeTimestampMandatoryEnd time for which the returns needs to be retrieved
YYYY-MM-DDThh:mm:ss
1002022-11-09T11:10:00

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 that case 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 Name Data Type Description Example
`return_reference_number` `String` The unique reference number of the return number "8036651667991648"
`status` `String` Status of the return request "SUCCESS"
`Return Request Timestamp` `String` The date and time of the return request "2022-11-09T11:00:48.702402Z"
`cp_id` `Num` The [carrier partner id](https://carriers.clickpost.ai/) 25
`cp_name` `String` The name of the carrier partner "Delhivery"
`account_code` `String` Name of the account registered by the enterprise on Clickpost dashboard for the carrier partner. Will return a 400 Bad Request response if the given account is inactive or does not exist. "Delhivery\_Reverse"
`return_tracking_id` `Num` The return tracking ID 506685194
`awb` `String` The air way bill number of the reverse shipment "2667237821710"
`timestamp` `String` The timestamp in UTC of the return request "2022-11-09T11:00:50.143090Z"
`refund_mode` `String` The mode of the refund for the return order "Back to source"
`source` `String` The source from where the return request was places "Returns Page"
`webhook_payload` `JSON Object` The webhook payload
`waybill` `String` The Air Way bill number of the reverse shipment "2667237821710"
`cp_id` `Num` The [carrier partner id](https://carriers.clickpost.ai/) 25
`status` `String` The status of the return order "Return Order Placed"
`location` `String` The location of the return order "Stark Tower, Navrangpura, Ahmedabad, 380015"
`clickpost_status_code` `Num` The clickpost tracking status.\ [Reference](https://docs.clickpost.ai/docs/tracking-status-codes) 101
`notification_event` `Num` The clickpost notification event code [https://docs.clickpost.ai/docs/notification-event](https://docs.clickpost.ai/docs/notification-event) 11
`clickpost_status_description` `String` The Clickpost tracking status description "Return Order Placed"
`clickpost_status_bucket` `Num` In case Enterprise wants to build a custom UI on top of this API, then they can build logic on top of this field [https://docs.clickpost.ai/docs/clickpost-status-bucket](https://docs.clickpost.ai/docs/clickpost-status-bucket) 8
`clickpost_status_bucket_description` `String` The description of the clubbed Clickpost Status bucket [https://docs.clickpost.ai/docs/clickpost-status-bucket](https://docs.clickpost.ai/docs/clickpost-status-bucket) "Return Order Placed"
`timestamp` `String` The timestamp in UTC of the return request "2022-11-09T11:00:48.702402Z"
`remark` `String` The remark sent by the carrier partner "Return Order Placed"
`account_code` `String` Name of the account registered by the enterprise with the carrier partner defined by carrier\_partner\_id field. Will return a 400 Bad Request response if the given account is inactive or does not exist. "Delhivery\_Reverse"
`additional` `JSON Object` The additional details for the particular return order
`latest_status` `JSON Object` The latest status of the return order 1. `location` 2. `remark` 3. `clickpost_status_code` 4. `clickpost_status_description` 5. `clickpost_status_bucket`\ 6.`clickpost_status_bucket_description` 6. `timestamp` 7. `status` \{\ "location": "",\ "remark": "Return Order Placed",\ "clickpost\_status\_code": 101,\ "clickpost\_status\_description": "Return Order Placed",\ "clickpost\_status\_bucket": 8,\ "clickpost\_status\_bucket\_description": "Return Order Placed",\ "timestamp": "2022-11-09T11:00:48.702402Z",\ "status": "Return Order Placed"\ }
`is_rvp` `Boolean` Whether the order is reverse or not true
`forward_awb` `String` The original AWB number of the forward shipment
`forward_reference_number` `String` The reference number of the forward shipment "2290664"
`forward_order_id` `String` The order ID of the forward shipment "103887038"
`notification_event_id` `Num` The clickpost notification event code [https://docs.clickpost.ai/docs/notification-event](https://docs.clickpost.ai/docs/notification-event) 11
`self_shipped` `Boolean` Whether the return shipment was self shipped by the customer or not false
`item_info` `Array` The details of the item being returned to origin [ { "sku": "4060981731573", "quantity": 1, "return_reason": "Other Reason", "refund_mode": "Back to source" }]
`sku` `String` The Stock Keeping Unit of the Item being returned "4060981731573"
`quantity` `Num` The quantity of the returned item 1
`return_reason` `String` The reason for the return "Size Issue"
`refund_mode` `String` The mode of the refund for the return order "Back to source"
`return_reference_number` `String` The reference number of the return order "8036651667991648"

Did this page help you?