Home›ONDC Transaction›Track

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.