> 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-customerorderid.md).

# Get Tracking Details via CustomerOrderId

#### API URL

**GET** /api/v2/shipping/trackingDetails?customerOrderId=45664

***

### What is the purpose of this API?

This API is used to fetch shipment tracking details using the **customerOrderId**.

Use this API when you want to retrieve tracking details for all shipments associated with a specific CustomerOrderNumber.

***

### Query Parameters

| Parameter       | Type   | Required | Description                                                                                                               |
| --------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------- |
| customerOrderId | string | Yes      | Unique number against each sales channel                                                                                  |
| trackingIds     | string | Optional | Tracking IDs of the order or return for which you want to get the tracking updates. You can pass maximum 50 tracking IDs. |
| channelId       | string | Optional | Unique Id for channel connection                                                                                          |

***

### Sample Request

```http
GET /api/v2/shipping/trackingDetails?customerOrderId=45664&trackingIds=593816218099&channelId=1234
```

***

### Sample Payload

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

***

#### 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.

<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>