Status
Get the detailed current state of an order directly from the
seller’s system via the ONDC on_status callback.
Returns the full order snapshot including fulfillment state, billing,
payment, quote, and cancellation terms.
Get Order Status
POST/ret11/status
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": "019c2f0a2c1d74dba2dec3aa6e9cb2c3"
}Response
Returns the full ONDC on_status response. The top-level
shape is:
| Field | Type | Description |
|---|---|---|
| context | object | ONDC context block with action: "on_status" |
| message.order | object | Full order object (see below) |
message.order fields
| Field | Type | Description |
|---|---|---|
| id | string | The order ID |
| state | string |
High-level order state: "Accepted" |
"In_progress" | "Completed" |
"Cancelled"
|
| provider | object |
Seller details — id and
locations[]
|
| items[] | array |
All ordered items with fulfillment_id,
quantity, and tags (type:
item or customization)
|
| billing | object | Full billing details (name, address, phone, email) |
| fulfillments[] | array | Current fulfillment state with start/end locations, contact info, and time ranges (see Fulfillment States) |
| quote | object | Current price breakdown (item totals, delivery charges, taxes, total) |
| payment | object | Payment details including status and settlement info |
| cancellation_terms[] | array | Per-fulfillment-state cancellation fee rules. Check before offering cancel. See Cancel. |
| created_at | string | ISO 8601 timestamp when the order was created |
| updated_at | string | ISO 8601 timestamp of the last order update |
Response Example
{
"data": {
"dto": {
"context": {
"domain": "ONDC:RET11",
"country": "IND",
"city": "std:080",
"action": "on_status",
"core_version": "1.2.0",
"bap_id": "ondc.highwaydelite.com",
"bap_uri": "https://ondc.highwaydelite.com/ret11",
"bpp_id": "pramaan.ondc.org/beta/preprod/mock/seller",
"bpp_uri": "https://pramaan.ondc.org/beta/preprod/mock/seller",
"transaction_id": "56a55c3f-8052-4bb6-91d6-47e1a178a0c0",
"message_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"timestamp": "2026-06-01T10:30:00.000Z",
"ttl": "PT30S"
},
"message": {
"order": {
"id": "019bb2ca-a956-71a8-83c1-397bc5a092f9",
"state": "Accepted",
"provider": {
"id": "pramaan_provider_1",
"locations": [
{ "id": "SSL1" }
]
},
"items": [
{
"id": "id_1cctu3_9_0",
"fulfillment_id": "6c00379b-17ec-42b1-bf36-037a744d2056",
"quantity": { "count": 1 },
"tags": [
{ "code": "type", "list": [{ "code": "type", "value": "item" }] }
]
}
],
"billing": {
"name": "John Doe",
"address": {
"door": "12-34",
"building": "MG Road",
"street": "MG Road",
"locality": "Indiranagar",
"city": "Bengaluru",
"state": "Karnataka",
"country": "IND",
"area_code": "560001"
},
"phone": "9876543210",
"email": "john@example.com",
"created_at": "2026-06-01T10:00:00.000Z",
"updated_at": "2026-06-01T10:00:00.000Z"
},
"fulfillments": [
{
"id": "6c00379b-17ec-42b1-bf36-037a744d2056",
"type": "Delivery",
"@ondc/org/provider_name": "Pramaan Store 1",
"tracking": true,
"@ondc/org/category": "Immediate Delivery",
"@ondc/org/TAT": "PT10M",
"state": {
"descriptor": { "code": "Packed" }
},
"start": {
"location": {
"id": "SSL1",
"descriptor": { "name": "Pramaan Store 1" },
"gps": "12.9716,77.5946"
},
"contact": { "phone": "9000000001" },
"time": {
"range": {
"start": "2026-06-01T10:30:00.000Z",
"end": "2026-06-01T10:45:00.000Z"
}
}
},
"end": {
"location": {
"gps": "12.9780,77.6410",
"address": {
"door": "12-34",
"building": "MG Road",
"street": "MG Road",
"locality": "Indiranagar",
"city": "Bengaluru",
"state": "Karnataka",
"country": "IND",
"area_code": "560001"
}
},
"contact": { "phone": "9876543210" },
"time": {
"range": {
"start": "2026-06-01T11:00:00.000Z",
"end": "2026-06-01T11:30:00.000Z"
}
}
}
}
],
"quote": {
"price": { "currency": "INR", "value": "610.00" },
"breakup": [
{
"@ondc/org/item_id": "id_1cctu3_9_0",
"title": "Double Patty Cheese Burger",
"@ondc/org/title_type": "item",
"price": { "currency": "INR", "value": "265.00" }
},
{
"@ondc/org/item_id": "6c00379b-17ec-42b1-bf36-037a744d2056",
"title": "Delivery charges",
"@ondc/org/title_type": "delivery",
"price": { "currency": "INR", "value": "40.00" }
},
{
"@ondc/org/item_id": "6c00379b-17ec-42b1-bf36-037a744d2056",
"title": "Tax",
"@ondc/org/title_type": "tax",
"price": { "currency": "INR", "value": "5.00" },
"item": {
"tags": [
{ "code": "quote", "list": [{ "code": "type", "value": "fulfillment" }] }
]
}
}
],
"ttl": "PT6H"
},
"payment": {
"params": {
"currency": "INR",
"amount": "610.00",
"transaction_id": "56a55c3f-8052-4bb6-91d6-47e1a178a0c0"
},
"status": "PAID",
"type": "ON-ORDER",
"collected_by": "BAP",
"@ondc/org/settlement_details": [
{
"settlement_counterparty": "seller-app",
"settlement_phase": "sale-amount",
"settlement_type": "upi",
"beneficiary_name": "Pramaan Store 1"
}
]
},
"cancellation_terms": [
{
"fulfillment_state": { "descriptor": { "code": "Pending" } },
"cancellation_fee": { "percentage": "0" }
},
{
"fulfillment_state": { "descriptor": { "code": "Packed" } },
"cancellation_fee": { "percentage": "0" }
},
{
"fulfillment_state": { "descriptor": { "code": "Order-picked-up" } },
"cancellation_fee": { "percentage": "10" }
},
{
"fulfillment_state": { "descriptor": { "code": "Out-for-delivery" } },
"cancellation_fee": { "percentage": "30" }
}
],
"tags": [
{
"code": "bpp_terms",
"list": [
{ "code": "np_type", "value": "MSN" },
{ "code": "tax_number", "value": "XXXXXXXXXXXXXXX" },
{ "code": "accept_bap_terms", "value": "Y" }
]
}
],
"created_at": "2026-06-01T10:00:00.000Z",
"updated_at": "2026-06-01T10:30:00.000Z"
}
}
},
"status": "ACK"
}
}Fulfillment States
The fulfillment state progresses in the following order for a standard delivery:
Pending
→
Packed
→
Agent-assigned
→
Order-picked-up
→
Out-for-delivery
→
Order-delivered
| State | Meaning |
|---|---|
| Pending | Order received, awaiting acceptance by the restaurant |
| Packed | Restaurant is preparing and packing the order |
| Agent-assigned | A delivery agent has been assigned to pick up the order |
| Order-picked-up | The delivery agent has collected the order from the restaurant |
| Out-for-delivery | Order is en route to the delivery address |
| Order-delivered | Order has been successfully delivered |