Get rates for a return shipment request
Fetch rates for a return request
Return requests can only be processed within 7 days after a shipment has been completed.
POST https://api.shipbubble.com/v1/shipping/returns/:order_id/fetch_rates
Path Parameters
Name
Type
Description
order_id*
String
order id of shipment to be returned
Request Body
Name
Type
Description
pickup_date*
String
specified date for shipment processing(format: "yyyy-mm-dd")
delivery_instructions
String
additional delivery instructions for package
sender_phone
String
New sender phone number in case of a change
reciever_phone
String
New receiver phone number in case of a change
{
"status": "success",
"message": "Retrieved successfully",
"data": {
"request_token": "b6130ff493a30a6065f677a45b0ee1dd92edd07e80e473837248e99edaa029cd",
"couriers": [
{
"courier_id": "sendstack",
"courier_name": "Sendstack",
"courier_image": "https://res.cloudinary.com/delivry/image/upload/v1653144587/courier_images/sendstack_ijfbxw.png",
"service_code": "sendstack",
"insurance": {
"code": "not available",
"fee": 0
},
"discount": {
"percentage": 10,
"symbol": "%",
"discounted": 95
},
"service_type": "pickup",
"waybill": false,
"tracking_level": 7,
"pickup_eta": "Next day pickup",
"pickup_eta_time": "2022-07-26 11:29:53",
"dropoff_station": null,
"pickup_station": null,
"delivery_eta": "Next day delivery",
"delivery_eta_time": "2022-07-27 11:29:53",
"info": [
"Shipment will be processed by Sendstack for next day pickup July 26th 2022 ",
"Shipment estimated delivery time is 24hrs (July 27th 2022) from day of pickup"
],
"currency": "NGN",
"vat": 71,
"ratings": 4.4,
"total": 1121
},
{
"courier_id": "N",
"courier_name": "DHL Nigeria",
"courier_image": "https://res.cloudinary.com/delivry/image/upload/v1639728337/courier_images/dhl.png",
"service_code": "dhl-nigeria",
"insurance": {
"code": "not available",
"fee": 0
},
"discount": {
"percentage": 50,
"symbol": "%",
"discounted": 5835
},
"service_type": "pickup",
"waybill": true,
"tracking_level": 7,
"pickup_eta": "Before 17:00 (GMT +1) July 25th 2022",
"pickup_eta_time": "2022-07-25 17:01:00",
"dropoff_station": null,
"pickup_station": null,
"delivery_eta": "Estimated 1 day (s)",
"delivery_eta_time": "2022-07-26 10:00:00",
"info": [
"Shipment placed after 4 PM (GMT +1) will be processed to the next day",
"Download waybill document from shipments page after shipment has been processed",
"Attach waybill document to your packaged items",
"Items to be shipped must be wrapped or packaged before pickup"
],
"currency": "NGN",
"vat": 437.63,
"ratings": 4.6,
"total": 6272.63
}
],
"fastest_courier": {
"courier_id": "N",
"courier_name": "DHL Nigeria",
"courier_image": "https://res.cloudinary.com/delivry/image/upload/v1639728337/courier_images/dhl.png",
"service_code": "dhl-nigeria",
"insurance": {
"code": "not available",
"fee": 0
},
"discount": {
"percentage": 50,
"symbol": "%",
"discounted": 5835
},
"service_type": "pickup",
"waybill": true,
"tracking_level": 7,
"pickup_eta": "Before 17:00 (GMT +1) July 25th 2022",
"pickup_eta_time": "2022-07-25 17:01:00",
"dropoff_station": null,
"pickup_station": null,
"delivery_eta": "Estimated 1 day (s)",
"delivery_eta_time": "2022-07-26 10:00:00",
"info": [
"Shipment placed after 4 PM (GMT +1) will be processed to the next day",
"Download waybill document from shipments page after shipment has been processed",
"Attach waybill document to your packaged items",
"Items to be shipped must be wrapped or packaged before pickup"
],
"currency": "NGN",
"vat": 437.63,
"ratings": 4.6,
"total": 6272.63
},
"cheapest_courier": {
"courier_id": "N",
"courier_name": "DHL Nigeria",
"courier_image": "https://res.cloudinary.com/delivry/image/upload/v1639728337/courier_images/dhl.png",
"service_code": "dhl-nigeria",
"insurance": {
"code": "not available",
"fee": 0
},
"discount": {
"percentage": 50,
"symbol": "%",
"discounted": 5835
},
"service_type": "pickup",
"waybill": true,
"tracking_level": 7,
"pickup_eta": "Before 17:00 (GMT +1) July 25th 2022",
"pickup_eta_time": "2022-07-25 17:01:00",
"dropoff_station": null,
"pickup_station": null,
"delivery_eta": "Estimated 1 day (s)",
"delivery_eta_time": "2022-07-26 10:00:00",
"info": [
"Shipment placed after 4 PM (GMT +1) will be processed to the next day",
"Download waybill document from shipments page after shipment has been processed",
"Attach waybill document to your packaged items",
"Items to be shipped must be wrapped or packaged before pickup"
],
"currency": "NGN",
"vat": 437.63,
"ratings": 4.6,
"total": 6272.63
},
"checkout_data": {
"ship_from": {
"name": "Lebron James",
"phone": "+2348057575855",
"email": "[email protected]",
"address": "Alh. Masha Rd, Surulere 101241, Lagos, Nigeria"
},
"ship_to": {
"name": "Lebron James",
"phone": "+2348057575855",
"email": "[email protected]",
"address": "Kafayat Abdulrasaq Street, Lekki Phase I 106104, Logos, Nigeria"
},
"package_amount": "₦1,510,000",
"package_weight": "2.00KG",
"pickup_time": "December 19th 2022, 10:57:44 PM"
}
}
}{
"status": "failed",
"message": "Return for shipment must be processed within 7 days of completion"
}Last updated
Was this helpful?