Get Tracking Details

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)

POST /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": "02-06-2024 03:52:09",
	  "expectedDeliveryDate" : "2024-06-26 23:42:16",
	  "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	Description
PACKED	The order has been packed and is ready for shipment.
APPROVED	The return has been created in Eshopbox and tracking ID (AWB) is assigned.
PICKUP_PENDING	The order is awaiting pickup by the carrier.
PICKUP_FAILED	The carrier attempted pickup but failed; rescheduling may be required.
CANCELLED_ORDER	The order has been cancelled and will not be processed further.
OUT_FOR_PICKUP	The order is out for pickup by the carrier.
PICKED_UP	The order has been picked up by the carrier and is in transit.
INTRANSIT	The order is on its way to the delivery destination.
OUT_FOR_DELIVERY	The order is out for delivery to the customer.
SHIPMENT_DELAYED	The shipment is delayed due to unforeseen circumstances.
CONTACT_CUSTOMER_CARE	Customer needs to contact customer care for more information regarding the shipment.
SHIPMENT_HELD	The shipment is held at a location due to issues that need to be resolved.
LOST	The shipment has been lost during transit.
DAMAGED	The shipment has been damaged during transit.
FAILED_DELIVERY	The delivery attempt failed; rescheduling may be required.
RTO_REQUESTED	Return to Origin (RTO) has been requested for the shipment.
RTO	The shipment is being returned to the origin due to various reasons (e.g., customer refusal).
RTO_OUT_FOR_DELIVERY	The RTO shipment is out for delivery back to the origin.
RTO_INTRANSIT	The RTO shipment is in transit back to the origin.
RTO_CONTACT_CUSTOMER_CARE	Customer needs to contact customer care regarding the RTO shipment.
RTO_SHIPMENT_DELAY	The RTO shipment is delayed during its return transit.
RTO_DELIVERED	The RTO shipment has been delivered back to the origin.
RTO_FAILED	The RTO delivery attempt failed; rescheduling may be required.
DELIVERED	The order has been successfully delivered to the customer.