Customer Feedback API
This API enables customers to retrieve feedback from end-users in case of failure of delivery of any shipment. Users can update their preferred location of delivery at Clickpost Tracking Page, and those changes are retrieved by this API.
Overview
Using this API, customers will be able to retrieve feedback from end-users when their shipment is in the failed delivery stage. Users can update their preferred location of delivery, preferred date for reattempt and can provide their mobile number at Clickpost Tracking Page, and those changes are retrieved by this API. With help of this API customers can collate and analyze data that is received from their end-customer.
Usecase
This is a standard API which applies to all orders.
URL
GET <https://www.clickpost.in/api/v1/ndr_user_feedback/>
Query Parameters
| Field Name | Data Type | Field | Description | Max Length | Example |
|---|---|---|---|---|---|
username | String | Mandatory | Username of the registered enterprise | 100 | Provided by Clickpost team |
key | String | Mandatory | Unique license key for the enterprise user | 100 | Provided by Clickpost team |
start_time | Integer | Mandatory | Epoch time (in seconds) denoting the start of the time period within which the feedback is required | 1666768415 | |
end_time | Integer | Mandatory | Epoch time (in seconds) denoting the end of the time period within which the feedback is required. | 1666772015 |
Response
The sample response can have the following fields
| Field Name | Data Type | Description |
|---|---|---|
meta | Object | Metadata for the result, e.g. status code, error messages. |
result | List of Objects | A list of objects, each denoting a feedback provided by the user. |
Response Meta
| Field Name | Data Type | Description |
|---|---|---|
status | Integer | Status code of the response (including, but not limited to HTTP Status codes) |
message | String | Error message (if any errors) for the request. |
success | Boolean | Whether the request is successful or not. |
Response Result Object
Each object in the result list may consist of the following fields.
| Field Name | Data Type | Description |
|---|---|---|
type | String | Type of NDR feedback received. Can be either CLIENT_OPS_FEED or CUSTOMER_FEED |
awb | String | AWB of the order for which NDR feedback is provided |
address | String/Null | Address of delivery, updated by the user at the tracking page |
landmark | String/Null | Landmark of the address of delivery, updated by the user at the tracking page |
drop_pincode | String/Null | Pincode of delivery address, updated by the user at the tracking page |
preferred_date | String/Null | Preferred date of delivery of the order (in YYYY-MM-DD format if not null) |
preferred_time | String/Null | Preferred time of delivery of the order (in HH:MM:SS format if not null) |
phone | String/Null | Phone number for delivery, updated at the tracking page |
comment | String/Null | Comment about the change of order by the user, updated at the tracking page |
created_at | String | Timestamp when the user requested the change of the above details (in YYYY-MM-DDTHH:MM:SS format) |
clickpost_status_code | Integer | Status code of the shipment when the end-user entered the feedback |
api_data_push | Boolean/Null | Whether the updated data has been pushed to the carrier partner APIs via Clickpost's API or not. Can take 3 values based on the course of action:
|
clickpost_status_description | String | Brief description of the status of the shipment when the end-user entered the feedback. |
is_rejected | Boolean/Null | Whether customer has rejected the shipment |
reference_number | String | Reference number of the shipment |
intent | String/Null | Customer's intent on if they agree with the courier's reason of failed delivery. |
feedback_source | String | The source from where the feedback was received to our system. |
data_shared_via_api | Boolean/Null | Wether the data was pushed through api successfully/ failed or was never attempted to push through api |
data_shared_via_api_timestamp | String/Null | Timestamp when the API was pushed to the courier (in ISO-8601 format) |
data_shared_via_file | Boolean/Null | Wether the data was pushed through file successfully/ failed or was never attempted to push through api |
data_shared_via_file_timestamp | String/Null | Timestamp when the file was pushed to the courier (in ISO-8601 format) |
action | String | The action corresponding to this feedback which will be passed to the courier. (INITIATE_RTO, REATTEMPT, DEFER_DLV, UPDATE_INFO) |
NDR count | Integer | The count of the NDR shipment this feedback corresponds to. |
additional | Object | Additional feedback related to steps taken internally by CST |
Response Result - 'additional' Field
| Field Name | Data Type | Description |
|---|---|---|
internal_username | String | The login username agent has used to retrieve feedback |
internal_cst_responded | Boolean | Whether customer support team of the enterprise has taken any action regarding the shipment |
internal_comment | String | Comments added by CST regarding the shipment |
Sample Response
{
"result": [
{
"type": "CUSTOMER_FEED",
"awb": "88444242821",
"address": null,
"landmark": null,
"drop_pincode": "141401",
"preferred_date": "2026-02-21",
"preferred_time": null,
"phone": null,
"comment": null,
"created_at": "2026-02-20T03:43:35.148309Z",
"clickpost_status_code": null,
"api_data_push": false,
"clickpost_status_description": null,
"is_rejected": false,
"reference_number": "2258032",
"intent": "reason confirmation: FALSE",
"feedback_source": "NDR_AI_AGENT",
"data_shared_via_api": true,
"data_shared_via_file": true,
"data_shared_via_api_timestamp": "2026-02-20T03:43:41.258730Z",
"data_shared_via_file_timestamp": "2026-02-20T06:43:06.456132Z",
"action": "REATTEMPT",
"NDR count": "2",
"additional": {
"internal_username": "puma",
"internal_cst_responded": true,
"internal_comment": "Mark as RTO"
}
},
{
"type": "CLIENT_OPS_FEED",
"awb": "14406222146670",
"address": null,
"landmark": null,
"drop_pincode": null,
"preferred_date": "2022-10-27",
"preferred_time": null,
"phone": null,
"comment": null,
"created_at": "2022-10-26T07:15:29.342983Z",
"clickpost_status_code": 9,
"api_data_push": true,
"clickpost_status_description": "Delivery Failed",
"is_rejected": null,
"reference_number": "2264139",
"additional": {
"internal_username": "puma",
"internal_cst_responded": false,
"internal_comment": "re-attempt\n"
}
},
{
"type": "CLIENT_OPS_FEED",
"awb": "14406222104411",
"address": null,
"landmark": null,
"drop_pincode": null,
"preferred_date": "2022-10-27",
"preferred_time": null,
"phone": null,
"comment": null,
"created_at": "2022-10-26T07:16:10.938830Z",
"clickpost_status_code": 9,
"api_data_push": true,
"clickpost_status_description": "Delivery Failed",
"is_rejected": null,
"reference_number": "2171425",
"additional": {
"internal_username": "puma",
"internal_cst_responded": false,
"internal_comment": "re-attempt\n"
}
},
{
"type": "CLIENT_OPS_FEED",
"awb": "SF170682117PUM",
"address": null,
"landmark": null,
"drop_pincode": null,
"preferred_date": "2022-10-27",
"preferred_time": null,
"phone": null,
"comment": null,
"created_at": "2022-10-26T07:16:18.491641Z",
"clickpost_status_code": 9,
"api_data_push": true,
"clickpost_status_description": "Delivery Failed",
"is_rejected": null,
"reference_number": "2265894",
"additional": {
"internal_username": "puma",
"internal_cst_responded": false,
"internal_comment": "Re scheduled for delivery"
}
}
],
"meta": {
"meta": {
"status": 200,
"message": "Success",
"success": true
}
}
}{
"meta": {
"status": 500,
"message": "(end_date-start_date) diff can not be more than 3600 seconds",
"success": false
}
}Updated 13 days ago
