Tutorial: Use the NDR Feedback API To Submit Non-Delivery Reports For Eligible Shipments
How to use the NdrFeedback API
API Version: v2
This tutorial explains the NDR (Non-Delivery Report) Feedback API which allows shippers to submit Non-Delivery Reports for eligible shipments. This API supportsndrActions such as Reschedule, Reattempt, and RTO (Return to Origin).
Note: This API is currently available only for the India (IN) marketplace.
The Submit NDR Feedback API provides shippers with an additional channel alongside Shipper Central to submit feedback and take appropriate actions on NDR-eligible shipments
Prerequisites
To successfully complete this tutorial, you must have the following prerequisites:
- Enrollment in an eligible program.
- A shipper central account to create and manage shipments.
- Authorization from the selling partner for whom you are making calls. Refer to Authorizing selling partner API applications for more information.
Submit NDR Feedback
The shipper can submit Non-Delivery Report (NDR) Feedback for eligible tracking IDs. When submitting feedback, the shipper must specify a ndrAction for the eligible shipment. The available actions are RESCHEDULE, REATTEMPT, and RTO (Return to Origin), from which the shipper can select one.
| NdrAction | Purpose |
|---|---|
| RESCHEDULE | The shipper can request to reschedule the shipment delivery to a specific date. Note: The rescheduleDate field is required and must specify the desired delivery date. |
| REATTEMPT | The Shipper can request a reattempt of the shipment delivery with additional delivery information. Note: The additionalAddressNotes field is required and must contain additional information associated with the delivery address. |
| RTO | The shipper can request to initiate a Return to Origin (RTO). |
Request Payload
| Name | Description | Required |
|---|---|---|
trackingId |
Tracking ID for the container for which tracking events are requested. Type: String |
Yes |
ndrAction |
The type of NDR action shipper wants to take for a particular shipment Type: Enum ["RESCHEDULE", "REATTEMPT", "RTO"] |
Yes |
rescheduleDate |
The date on which the Seller wants to reschedule shipment delivery, in ISO-8601 date/time format. Type: String |
No |
additionalAddressNotes |
Additional information related to the delivery address of the shipment. Type: String |
No |
Request example
POST https://sellingpartnerapi-eu.amazon.com/shipping/v2/ndrFeedback
{
"trackingId": "342102182148",
"ndrAction": "REATTEMPT",
"ndrRequestData": {
"rescheduleDate": "2026-08-09T13:29:26.824Z",
"additionalAddressNotes": "Near circle"
}
}
{
"trackingId": "342102182148",
"ndrAction": "RTO",
"ndrRequestData": {
"rescheduleDate": "2026-08-09T13:29:26.824Z",
"additionalAddressNotes": "Near circle"
}
}
{
"trackingId": "342102182148",
"ndrAction": "RESCHEDULE",
"ndrRequestData": {
"rescheduleDate": "2026-08-09T13:29:26.824Z",
"additionalAddressNotes": "Near circle"
}
}
Request header parameters
| Name | Description | Required |
|---|---|---|
x-amzn-shipping-business-id |
Amazon shipping business to assume for this request. Type: enum |
Yes |
x-amz-access-token |
Amazon shipping request token |
Yes |
Sample API Request
POST https://sellingpartnerapi-eu.amazon.com/shipping/v2/ndrFeedback
x-amzn-shipping-business-id: AmazonShipping_IN
x-amz-access-token: Atza|IwEBIGorlXXX
Response
It returns Empty Object Body with Http Status code as 200.
FAQs
1: Which are the required fields in the payload?
trackingId and ndrAction are mandatory fields and must always be provided.
Additionally: If ndrAction is set to Reschedule, rescheduleDate is mandatory. If ndrAction is set to Reattempt, additionalAddressNotes is mandatory.
2: What is additionalAddressNotes and what information can be provided?
AdditionalAddressNotes contains additional information associated with the recipient's delivery address. It can include supplementary address details or an alternate phone number. The field has a maximum character limit of 256 characters.
3: Can I continue to submit NDR feedback through bulk Excel upload in Shipper Central?
Yes. You can continue to use the bulk upload functionality in Shipper Central to submit NDR feedback.
4: We are not enabled for NDR push notifications; can we still submit NDR feedback via API?
Yes, you can use NDR feedback API to submit the feedback even without NDR push notifications. You can refer NDR UI to fetch the list of eligible shipments and submit feedback through the API for the corresponding tracking IDs.
Push Notifications - NDR Eligible Shipments notification provides information about NDR-eligible shipments, except for address-related details.
5: Will we also get a performance summary via API?
No. The performance summary is not available through the API. However, you can continue to view and fetch the performance summary from the NDR Portal : https://ship.amazon.in/non-delivery-report
Updated 8 days ago