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.