# useMin

*Category:* Utilities
*Section:* Data aggregation hooks
*Source:* https://uikit.developers.rio.cloud/#/utilities/useMin
*Captured:* 2026-04-27T14:59:46.997Z

Returns the smallest valid numeric value found at the specified path within a list of objects. Handles localized number strings and safely ignores invalid values.

## useMin

### Example: Example 1

Lowest shipment value: 850 €

#### React (tsx)

```tsx
import { FormattedNumber, IntlProvider } from 'react-intl';
import useMin from '@rio-cloud/rio-uikit/useMin';

const deliveries = [
    { shipment: { value: '2.345,50 €' } },
    { shipment: { value: '1.000,75 €' } },
    { shipment: { value: 850 } },
    { shipment: { value: '2.000' } },
];

export default () => {
    const minValue = useMin(deliveries, 'shipment.value', {
        locale: 'de-DE',
    });

    return (
        <IntlProvider locale='de-DE'>
            <div>
                Lowest shipment value:{' '}
                <FormattedNumber
                    value={minValue}
                    style='currency'
                    currency='EUR'
                    minimumFractionDigits={0}
                    maximumFractionDigits={0}
                />
            </div>
        </IntlProvider>
    );
};
```

#### HTML (html)

```html
<div>Lowest shipment value: 850&nbsp;€</div>
```

#### Props: Options for the `useMin` hook

### Options for the `useMin` hook

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| items | unknown[] | — | The array of objects to evaluate. |
| path | string | — | Dot-separated path to the numeric value inside each object. |
| options | object | — | Optional configuration for number parsing. |
| └locale | string | "en-GB" | Locale string used for parsing localized number formats. Affects grouping and decimal separator interpretation. |

#### Props: Return value of the `useMin` hook

### Return value of the `useMin` hook

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| value | number | — | The smallest valid numeric value found at the given path, or 0 if none could be parsed. |