Tracking an order

This API allows you to fetch the tracking URL for any order using the customer order ID and shipping mobile number associated with the order.

🔗 Endpoint

GET

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

🧩 Dynamic Values

Field	Description
<track-domain>	Your Eshopbox tracking domain. You can find this in Eshopbox workspace → Settings → Customer portal → Setup your tracking page domain. Example: track.eshopbox.com
vendorOrderNumber	Customer Order ID of the order
mobile	Shipping phone number associated with the order

📥 Request Example

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

---

✅ Success Response (200)

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

Response Fields

Field	Description
trackingUrl	Encoded tracking URL for the order. Use this to redirect the customer.
created_at	Timestamp when the order was created.
customerOrderNumber	Customer Order ID matching the request.

⛔ Error Response (400)

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

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