> 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/orders/tracking-an-order.md).

# Tracking an order

### 🔗 **Endpoint**

#### **GET**

```
https://<track-domain>/api/v1/tracking-url?vendorOrderNumber=<vendorOrderNumber>&mobile=<mobile>
```

### 🧩 **Dynamic Values**

<table><thead><tr><th width="228.89581298828125">Field</th><th>Description</th></tr></thead><tbody><tr><td><code>&#x3C;track-domain></code></td><td>Your Eshopbox tracking domain. You can find this in <strong>Eshopbox workspace → Settings → Customer portal → Setup your tracking page domain</strong>. Example: <code>track.eshopbox.com</code></td></tr><tr><td><code>vendorOrderNumber</code></td><td>Customer Order ID of the order</td></tr><tr><td><code>mobile</code></td><td>Shipping phone number associated with the order</td></tr></tbody></table>

### 📥 **Request Example**

```
GET https://eshopboxdemo3458.eshopbox.com/api/v1/tracking-url?vendorOrderNumber=ORDER1234&mobile=9999999999
```

***

### ✅ **Success Response (200)**

```json
{
    "orders": [
        {
            "trackingUrl": "https://eshopboxdemo3458.eshopbox.com/VklTMTUyIyMjIzc2NTQ1Njc41Dk=",
            "created_at": "2025-12-08 18:03:17",
            "customerOrderNumber": "ORDER123"
        }
    ]
}
```

#### **Response Fields**

<table><thead><tr><th width="283.1796875">Field</th><th>Description</th></tr></thead><tbody><tr><td><code>trackingUrl</code></td><td>Encoded tracking URL for the order. Use this to redirect the customer.</td></tr><tr><td><code>created_at</code></td><td>Timestamp when the order was created.</td></tr><tr><td><code>customerOrderNumber</code></td><td>Customer Order ID matching the request.</td></tr></tbody></table>

### ⛔ **Error Response (400)**

Occurs when the order does not exist or incorrect `vendorOrderNumber` is provided.

```json
{
    "error": {
        "errors": [
            {
                "domain": "global",
                "reason": "badRequest",
                "message": "CustomerOrderNumber not found"
            }
        ],
        "code": 400,
        "message": "CustomerOrderNumber not found"
    }
}
```