# 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="316">Status</th><th width="493">Description</th></tr></thead><tbody><tr><td>PACKED</td><td>The order has been packed and is ready for shipment.</td></tr><tr><td>APPROVED</td><td>The return has been created in Eshopbox and tracking ID (AWB) is assigned.</td></tr><tr><td>PICKUP_PENDING</td><td>The order is awaiting pickup by the carrier.</td></tr><tr><td>PICKUP_FAILED</td><td>The carrier attempted pickup but failed; rescheduling may be required.</td></tr><tr><td>CANCELLED_ORDER</td><td>The order has been cancelled and will not be processed further.</td></tr><tr><td>OUT_FOR_PICKUP</td><td>The order is out for pickup by the carrier.</td></tr><tr><td>PICKED_UP</td><td>The order has been picked up by the carrier and is in transit.</td></tr><tr><td>INTRANSIT</td><td>The order is on its way to the delivery destination.</td></tr><tr><td>OUT_FOR_DELIVERY</td><td>The order is out for delivery to the customer.</td></tr><tr><td>SHIPMENT_DELAYED</td><td>The shipment is delayed due to unforeseen circumstances.</td></tr><tr><td>CONTACT_CUSTOMER_CARE</td><td>Customer needs to contact customer care for more information regarding the shipment.</td></tr><tr><td>SHIPMENT_HELD</td><td>The shipment is held at a location due to issues that need to be resolved.</td></tr><tr><td>LOST</td><td>The shipment has been lost during transit.</td></tr><tr><td>DAMAGED</td><td>The shipment has been damaged during transit.</td></tr><tr><td>FAILED_DELIVERY</td><td>The delivery attempt failed; rescheduling may be required.</td></tr><tr><td>RTO_REQUESTED</td><td>Return to Origin (RTO) has been requested for the shipment.</td></tr><tr><td>RTO</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>The RTO shipment is out for delivery back to the origin.</td></tr><tr><td>RTO_INTRANSIT</td><td>The RTO shipment is in transit back to the origin.</td></tr><tr><td>RTO_CONTACT_CUSTOMER_CARE</td><td>Customer needs to contact customer care regarding the RTO shipment.</td></tr><tr><td>RTO_SHIPMENT_DELAY</td><td>The RTO shipment is delayed during its return transit.</td></tr><tr><td>RTO_DELIVERED</td><td>The RTO shipment has been delivered back to the origin.</td></tr><tr><td>RTO_FAILED</td><td>The RTO delivery attempt failed; rescheduling may be required.</td></tr><tr><td>DELIVERED</td><td>The order has been successfully delivered.     </td></tr><tr><td>RECEIVED</td><td>The return has been received at the Fulfilment center.</td></tr><tr><td>DELIVERED_WAREHOUSE</td><td>The return QC has been completed at the Fulfilment center.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://eshop.gitbook.io/eshopbox-developers/order/shipper-integration-wrapper-api/get-tracking-details-via-polling.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.