Track
Get real-time tracking information for a confirmed and dispatched order. Returns the ONDC on_track response, which includes a live tracking URL provided by the delivery partner.
Track Order
POST/ret11/track
Auth Required
Include a Bearer token. See Authentication.
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| orderId | string | required | Order ID from create-order |
Request Example
{
"orderId": "019c2de8-473c-7ecd-805f-114265059096"
}Response
Returns the full ONDC on_track response. The top-level shape is:
| Field | Type | Description |
|---|---|---|
| context | object | ONDC context block with action: "on_track" |
| message.tracking | object | Tracking details including URL and status (see below) |
message.tracking fields
| Field | Type | Description |
|---|---|---|
| url | string | Live tracking URL from the delivery partner. Open in a browser or webview to show real-time delivery progress. |
| status | string | Tracking availability: "active" when a live URL is available, "inactive" when tracking is not yet available |
Response Example
{
"context": {
"domain": "ONDC:RET11",
"country": "IND",
"city": "std:080",
"action": "on_track",
"core_version": "1.2.0",
"bap_id": "buyer-app.example.com",
"bap_uri": "https://buyer-app.example.com/",
"bpp_id": "seller-app.example.com",
"bpp_uri": "https://seller-app.example.com/",
"transaction_id": "123f090-48b9-a9c5-6db5be6621dh",
"message_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"timestamp": "2024-01-15T11:05:00.000Z",
"ttl": "PT30S"
},
"message": {
"tracking": {
"url": "https://track.deliverypartner.example.com/order/019c2de8-473c-7ecd-805f-114265059096",
"status": "active"
}
}
}When to Call
Use this endpoint after the order is confirmed and the delivery agent has been assigned (fulfillment state Agent_assigned or later). Use Status to check the current fulfillment state before calling track. If called too early, status may be "inactive" and url may be absent.