Get Tracking Details via polling

Retrieve detailed tracking information for your shipments, ensuring you and your customers are always informed about their current status and location.

Get Tracking details (Max limit 50)

Get /api/v1/shipping/trackingDetails?trackingIds=1223,44567

Get tracking updates of the tracking ID.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Query Parameters

Name	Type	Description
trackingIds	string	Tracking IDs of the order or return for which you want to get the tracking updates. You can pass maximum 50 tracking IDs.

Response

200

{
  "Status": "SUCCESS",
  "trackingDetails": [
    {
      "journeyType" : "forward",
	  "customerOrderNumber" : "ORD13243",
      "trackingId": "80224636450",
      "currentStatus": "PICKUP_PENDING",
      "dateTime": "2024-06-02 03:52:09",
	  "expectedDeliveryDate" : "2024-06-26",
	  "courierPartnerName" : "Delhivery 500 gm Forward",
	  "statusLogs":[
		{
		  "status" : "created",
		  "remarks" : "",
		  "location": "Mumbai_Turbhe_C (Maharashtra)",
          "city": "Navi Mumbai",
          "state": "Maharashtra",
          "country": "India",
          "dateTime" : ""
        },
        {
          "status" : "accepted",
		  "remarks" : "",
		  "location": "Mumbai_Turbhe_C (Maharashtra)",
          "city": "Navi Mumbai",
          "state": "Maharashtra",
          "country": "India",
          "dateTime" : ""
        },
        {
		  "status" : "failed_delivery",
		  "ndrStatus" : "incomplete address",
		  "remarks" : "",
		  "location": "Mumbai_Turbhe_C (Maharashtra)",
          "city": "Navi Mumbai",
          "state": "Maharashtra",
          "country": "India",
          "dateTime" : ""
        },
        {
		  "status" : "ndr_resolution",
		  "remarks" : "",
		  "location": "Mumbai_Turbhe_C (Maharashtra)",
          "city": "Navi Mumbai",
          "state": "Maharashtra",
          "country": "India",
          "dateTime" : ""
        }
    },
	{
	  "journeyType" : "forward",
	  "customerOrderNumber" : "GTRDEG63",
      "trackingId": "12345678",
      "currentStatus": "PICKUP_PENDING",
      "dateTime": "02-06-2024 03:52:09,
	  "expectedDeliveryDate" : "2024-06-26 23:42:16",
	  "courierPartnerName" : "Delhivery 500 gm Forward"
    }
  ]
}

400

{
    "error": {
        "errors": [
            {
                "domain": "global",
                "reason": "badRequest",
                "message": "Invalid Request"
            }
        ],
        "code": 400,
        "message": "Invalid Request"
    }
}

curl --location -g 'https://wms.eshopbox.com/api/v1/shipping/trackingDetails?trackingIds=1223%2C44567' \
--header 'Authorization: Bearer <Token>'

Tracking Statuses

Below is a detailed list of the tracking statuses available in Eshopbox. Each status provides insight into the current state of an order as it progresses through the shipping process, from packing to delivery or return. These statuses are essential for tracking the shipment's journey, ensuring transparency and accurate updates for both forward and reverse logistics.

Status	Workspace Status	Description
PACKED	Ready to ship	The order has been packed and is ready for shipment.
APPROVED	Awaiting pickup	The return has been created in Eshopbox and tracking ID (AWB) is assigned.
PICKUP_PENDING	Ready to ship	The order is awaiting pickup by the carrier.
PICKUP_FAILED	Ready to ship	The carrier attempted pickup but failed; rescheduling may be required.
CANCELLED_ORDER	Cancelled	The order has been cancelled and will not be processed further.
OUT_FOR_PICKUP	Ready to ship	The order is out for pickup by the carrier.
PICKED_UP	On the way	The order has been picked up by the carrier and is in transit.
INTRANSIT	On the way	The order is on its way to the delivery destination.
OUT_FOR_DELIVERY	Out for delivery	The order is out for delivery to the customer.
SHIPMENT_DELAYED	On the way	The shipment is delayed due to unforeseen circumstances.
CONTACT_CUSTOMER_CARE	On the way	Customer needs to contact customer care for more information regarding the shipment.
SHIPMENT_HELD	On the way	The shipment is held at a location due to issues that need to be resolved.
LOST	Lost in transit	The shipment has been lost during transit.
DAMAGED	Damaged	The shipment has been damaged during transit.
FAILED_DELIVERY	On the way	The delivery attempt failed; rescheduling may be required.
RTO_REQUESTED	Return on the way	Return to Origin (RTO) has been requested for the shipment.
RTO	Return on the way	The shipment is being returned to the origin due to various reasons (e.g., customer refusal).
RTO_OUT_FOR_DELIVERY	Return on the way	The RTO shipment is out for delivery back to the origin.
RTO_INTRANSIT	Return on the way	The RTO shipment is in transit back to the origin.
RTO_CONTACT_CUSTOMER_CARE	Return on the way	Customer needs to contact customer care regarding the RTO shipment.
RTO_SHIPMENT_DELAY	Return on the way	The RTO shipment is delayed during its return transit.
RTO_DELIVERED	Return Delivered	The RTO shipment has been delivered back to the origin.
RTO_FAILED	Return on the way	The RTO delivery attempt failed; rescheduling may be required.
DELIVERED	Delivered	The order has been successfully delivered.
RECEIVED	Return in processing	The return has been received at the Fulfilment center.
DELIVERED_WAREHOUSE	Restocked, Quarantined, and Damaged	The return QC has been completed at the Fulfilment center.