Home›Orders›List Orders

List Orders

Retrieve the authenticated user’s order history with pagination.

Get User Orders

GET/ret11/orders
Auth Required

Include a Bearer token.

Parameters

Parameter In Required Description
page query optional Page number. Default: 1
limit query optional Items per page. Default: 10
userId query optional Your own platform's user ID for the logged-in user

Response

Returns a data array of order summary objects. Note: the list is directly under data, not nested under data.orders.

Field Type Description
data[] array Array of order summaries
data[].id string Order ID (use in order-details, status, etc.)
data[].state string Current order state. E.g., "Accepted", "Completed", "Cancelled"
data[].paymentOrderStatus string Payment status: "SUCCESS" | "PENDING" | "FAILED"
data[].confirmedAt string ISO 8601 order confirmation timestamp
data[].providerId string Restaurant/provider ID
data[].providerName string Restaurant display name
data[].providerImage string Restaurant image URL
data[].fulfillments[] array Fulfillment entries. Each has an id.
data[].items[] array Ordered items with itemName, quantity, itemType, parentItemId
data[].quote.value string Total order amount
data[].orderRating number | null User rating if submitted
data[].orderCancelFulfillments[] array Cancel/return fulfillment entries (if any)

Example Request

GET /ret11/orders?page=1&limit=10

Response Example

{
  "data": [
    {
      "id": "019bb2ca-a956-71a8-83c1-397bc5a092f9",
      "providerId": "pramaan_provider_1",
      "confirmedAt": "2026-06-01T10:00:00.000Z",
      "state": "Completed",
      "paymentOrderStatus": "SUCCESS",
      "providerName": "Pramaan Store 1",
      "providerImage": "https://pramaan.ondc.org/beta/preprod/mock/seller/assets/logo/store1.png",
      "fulfillments": [
        { "id": "6c00379b-17ec-42b1-bf36-037a744d2056" }
      ],
      "items": [
        {
          "itemName": "Double Patty Cheese Burger",
          "quantity": 1,
          "itemType": "item",
          "parentItemId": null
        }
      ],
      "quote": {
        "value": "610.00"
      },
      "orderRating": 4,
      "orderCancelFulfillments": []
    }
  ]
}