> For the complete documentation index, see [llms.txt](https://routelift.gitbook.io/routelift-api-integration/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://routelift.gitbook.io/routelift-api-integration/api-reference/markdown.md).

# Track Delivery

**Endpoint:**\
`GET /v1/deliveries/track/:trackingCode`\
This endpoint retrieves delivery details based on the tracking code.\
\
Base URL

* Test: `https://sandbox-integrations.routelift.com/v1/deliveries/track/:trackingCode`
* Live: `https://integrations.routelift.com/v1/deliveries/track/:trackingCode`

***

#### Sample Response

```json
{
  "success": true,
  "data": {
    "currentStep": "",
    "deliveryTimeLine": [
      {
        "title": "Order Created",
        "time": "2025-05-21T09:00:00Z",
        "isDone": true
      },
      {
        "title": "Pickup Scheduled",
        "time": "2025-05-21T10:00:00Z",
        "isDone": true
      },
      {
        "title": "Package Picked Up",
        "time": "2025-05-21T11:00:00Z",
        "isDone": true
      },
      {
        "title": "Out for Delivery",
        "time": "2025-05-21T12:00:00Z",
        "isDone": true
      },
      {
        "title": "Delivered",
        "time": null,
        "isDone": false
      }
    ],
    "trackingCode": "RL123456789",
    "status": "ongoing",
    "orderId": "ORD001234",
    "deliveryOtp": "1234",
  },
  "message": "Tracking information retrieved successfully"
}
```

***

Available Status

```
- assigned
- pending
- ongoing
- completed
- cancelled
- failed

```

#### Response Fields

| Field              | Type             | Description                                                                     |
| ------------------ | ---------------- | ------------------------------------------------------------------------------- |
| success            | boolean          | Indicates if the request was successful                                         |
| data               | object           | Contains delivery details                                                       |
| └ currentStep      | string           | Current step in the delivery process                                            |
| └ deliveryTimeLine | array of objects | Events and updates in the delivery journey                                      |
| └ title            | string           | Title of the event (e.g., "Order Created")                                      |
| └ time             | string or null   | Timestamp of the event (ISO 8601 format)                                        |
| └ isDone           | boolean          | Whether the event has been completed                                            |
| └ trackingCode     | string           | Unique tracking code for the delivery                                           |
| └ deliveryOtp      | string           | The delivery otp sent to the user to be given to the rider to authorize dropoff |
| └ status           | string           | Current status of the delivery (e.g., in\_transit)                              |
| └ orderId          | string           | Reference ID for the order                                                      |
| message            | string           | Additional info or explanation                                                  |