> For the complete documentation index, see [llms.txt](https://eshop.gitbook.io/eshopbox-developers/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://eshop.gitbook.io/eshopbox-developers/order/shipper-integration-wrapper-api/get-tracking-details-via-polling.md).

# Get Tracking Details via polling

## Get Tracking details (Max limit 50)

<mark style="color:green;">`Get`</mark> /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**

{% tabs %}
{% tab title="200" %}

```json
{
  "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"
    }
  ]
}
```

{% endtab %}

{% tab title="400" %}

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

{% endtab %}
{% endtabs %}

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

### Tracking Statuses&#x20;

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.

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