Home›Orders›Order Details

Order Details

Retrieve complete details for a single order including items, pricing, fulfillment state, and return eligibility.

Get Order Details

GET/ret11/orders/order-details/{orderId}

Auth Required

Include a Bearer token.

Parameters

Parameter	In	Required	Description
orderId	path	required	Order ID from create-order or list orders
userId	query	optional	Required only for service-account tokens

Response

Field	Type	Description
data.id	string	Order identifier
data.state	string	Current order state (e.g., `"Accepted"`, `"Completed"`, `"Cancelled"`)
data.paymentOrderStatus	string	Payment status: `"SUCCESS"` \| `"FAILED"` \| `"INITIATED"`
data.providerId	string	Restaurant/provider ID
data.bppId	string	ONDC seller BPP identifier
data.providerName	string	Restaurant display name
data.providerImage	string	Restaurant image URL
data.confirmedAt	string	ISO 8601 order confirmation timestamp
data.completedAt	string \| null	ISO 8601 completion timestamp. `null` if not yet completed.
data.cancelledAt	string \| null	ISO 8601 cancellation timestamp. `null` if not cancelled.
data.items[]	array	Ordered items
data.items[].itemId	string	Item identifier
data.items[].itemName	string	Item display name
data.items[].quantity	number	Quantity ordered
data.items[].itemType	string	`"item"` or `"customization"`
data.items[].parentItemId	string \| null	Parent item ID for customization entries
data.items[].returnable	boolean	Whether the item is eligible for return
data.items[].returnWindow	string	ISO 8601 return window duration. Example: `"PT1H"`
data.quote	object	Price breakdown
data.quote.value	string	Total order amount
data.quote.breakup[]	array	Line-item breakdown: `title`, `titleType`, `quantity`, `currency`, `value`, `parentItemId`
data.fulfillments[]	array	Delivery fulfillment entries
data.fulfillments[].fulfillmentId	string	Fulfillment identifier
data.fulfillments[].type	string	Fulfillment type. E.g., `"Delivery"`
data.fulfillments[].state	string	Current fulfillment state
data.fulfillments[].orderFulfillmentStateHistories[]	array	Timeline of fulfillment state changes. Each entry: `state`, `stateUpdatedAt`
data.billing	object	Billing details: `name`, `email`, `phone`, `addressName`, `building`, `locality`, `city`, `state`, `country`, `areaCode`
data.orderCancelFulfillments[]	array	Return/cancellation fulfillment history (if any)
data.orderRating	object \| null	Submitted ratings: `orderRating`, `providerRating`, `fulfilmentRating`, `agentRating`, `feedbackUrl`, `itemsRating`

Response Example

{
  "data": {
    "id": "019c2d8c-a956-71a8-83c1-397bc5a092f9",
    "state": "Completed",
    "providerId": "pramaan_provider_1",
    "bppId": "pramaan.ondc.org/beta/preprod/mock/seller",
    "providerName": "Pramaan Store 1",
    "providerImage": "https://pramaan.ondc.org/beta/preprod/mock/seller/assets/logo/store1.png",
    "paymentOrderStatus": "SUCCESS",
    "confirmedAt": "2026-06-01T10:00:00.000Z",
    "completedAt": "2026-06-01T10:45:00.000Z",
    "cancelledAt": null,
    "items": [
      {
        "itemId": "id_1cctu3_9_0",
        "itemName": "Double Patty Cheese Burger",
        "quantity": 1,
        "itemType": "item",
        "parentItemId": null,
        "returnable": true,
        "returnWindow": "PT1H"
      }
    ],
    "quote": {
      "value": "610.00",
      "breakup": [
        {
          "title": "Double Patty Cheese Burger",
          "titleType": "item",
          "quantity": 1,
          "currency": "INR",
          "value": "265.00",
          "parentItemId": null
        },
        {
          "title": "Delivery charges",
          "titleType": "delivery",
          "quantity": null,
          "currency": "INR",
          "value": "40.00",
          "parentItemId": null
        }
      ]
    },
    "fulfillments": [
      {
        "fulfillmentId": "6c00379b-17ec-42b1-bf36-037a744d2056",
        "type": "Delivery",
        "state": "Order-delivered",
        "endName": "John Doe",
        "endCity": "Bengaluru",
        "endState": "Karnataka",
        "endAreaCode": "560001",
        "endLocality": "MG Road",
        "endBuilding": "12-34",
        "endGps": "12.9716,77.5946",
        "contactName": "John Doe",
        "contactPhone": "9876543210",
        "contactEmail": "john@example.com",
        "orderFulfillmentStateHistories": [
          { "state": "Accepted", "stateUpdatedAt": "2026-06-01T10:05:00.000Z" },
          { "state": "In-progress", "stateUpdatedAt": "2026-06-01T10:20:00.000Z" },
          { "state": "Order-picked-up", "stateUpdatedAt": "2026-06-01T10:30:00.000Z" },
          { "state": "Order-delivered", "stateUpdatedAt": "2026-06-01T10:45:00.000Z" }
        ]
      }
    ],
    "billing": {
      "name": "John Doe",
      "email": "john@example.com",
      "phone": "9876543210",
      "addressName": "Home",
      "building": "12-34",
      "locality": "MG Road",
      "city": "Bengaluru",
      "state": "Karnataka",
      "country": "IND",
      "areaCode": "560001"
    },
    "orderCancelFulfillments": [],
    "orderRating": {
      "orderRating": 4,
      "providerRating": 5,
      "fulfilmentRating": 4,
      "agentRating": 4,
      "feedbackUrl": "https://www.sellerapp.com/rating-capture",
      "itemsRating": []
    }
  }
}

Return Eligibility

Check items[].returnWindow to determine if a return can still be initiated. If the return window has passed, the update endpoint will reject the request.