---
title: Function: useOrders
slug: chord-ui/function-useorders
docTags: 
createdAt: 2023-11-06T15:03:31.904Z
---

[react-autonomy](docId\:zoZ6W56ubpPACr0PO0GLS).useOrders

▸ **useOrders**(`options?`): [`UseOrders`](docId:1Y5Mg-25Noqy5QVuNGpP3)

The `useOrders` hook returns an object representing the current user's
orders.

This hook has a side effect that will load all the user's orders upon
calling it, if not already loaded. Optionally, an object can be passed to
the hook to expand the `orders` object to include additional properties.
This looks like `useOrders({ includeDetails: true })`. This `includeDetails`
option only applies to the initial load of the orders.



```javascript
import { useOrders } from '@chordcommerce/react-autonomy'

const OrdersPage = () => {
  const { orders, isLoaded, isFetching, error } = useOrders()

  if (isFetching) {
    return <p>Loading…</p>
  }

  return (
    <dl>
      {orders.map(order => (
        <React.Fragment key={order.number}>
          <dt>Order #{order.number}</dt>
          <dd>
            Total price: {order.displayTotal}
            <br />
            (Items: {order.lineItems.map(li => li.sku).join(', ')})
          </dd>
        </React.Fragment>
      )}
    </dl>
  )
}
```

### Parameters

| Name                      | Type      |
| ------------------------- | --------- |
| `options?`                | `Object`  |
| `options.includeDetails?` | `boolean` |

### Returns

[`UseOrders`](docId:1Y5Mg-25Noqy5QVuNGpP3)

### Defined in

[packages/react-autonomy/src/hooks/use-orders.ts:53](https://github.com/chordcommerce/chord-ui/blob/2b105e1/packages/react-autonomy/src/hooks/use-orders.ts#L53)