# Money and quantities

How the API represents money, rates, and product quantities in every request and response.

Source: https://getolet.com/resources/developers/money-and-quantities/
Updated: 2026-10-15

Money and quantities are always plain integers or fixed-decimal numbers on the OLET API, never floating point dollars. Read a value the way this page describes it and your totals will match what shows up in the back office.

## How is money represented

Most amounts are integer cents. A value of `1999` means $19.99. This applies to a product's `retail_price`, a sale's `total` and `paid_total`, a stock `unit_cost`, and the other totals on a sale.

A sale line's `list_price`, `unit_price` and `unit_discount` are different: they are integers with 4 decimal places, so `12345` means `1.2345`. This extra precision exists because a unit price can be set below one cent per unit on some products.

Rates, such as a tax `rate` or a discount percentage, are integer basis points, where 1 basis point is 1/100 of a percent. So `250` basis points is 2.5%. A supplier's `default_markup` is a rate too.

`SaleDiscount.value` changes shape depending on `value_type`: it is cents when `value_type` is `fixed`, and basis points when `value_type` is `percent`.

```bash
curl https://api.oletapp.com/your-store/v1/sales \
  -H "Authorization: Bearer olet_live_YOUR_API_KEY"
```

```js
const sales = await response.json() // { data: [...], next_cursor, has_more }
const dollars = sales.data[0].paid_total / 100
```

## How are quantities represented

Quantities are plain JSON numbers with up to 3 decimal places, for example `2.5` or `0.125` units. Sending a value with more than 3 decimal places is rejected as a validation error rather than being silently rounded, so round on your side before sending a request.

## Where to go next

See [pagination and polling](/resources/developers/pagination-and-polling/) for how list endpoints page through these values, or the full [API reference](/resources/developers/reference/) for every field's exact shape.