# List orders and see refunds

October 22, 2026 · API

You can now list a person's orders, hear when one is refunded, and schedule around the pickup time.

## What changed

- **`GET /v1/orders`.** Your orders, newest first, 20 a page by default and up to 100. Filter by `userId`.
- **`order.refunded`.** A new webhook for each refund. Add it to a subscription to receive it. The order's `refunded_minor` is the total refunded so far.
- **`ready_at`.** The pickup time as a timestamp, or `null` when the store gave none. `ready_eta` stays the text to show.
- **Build progress.** A cart that is still building says how far along it is in `build`.

## What to do

Read `refunded_minor` or listen for `order.refunded` instead of waiting for a refunded state, which is never sent. See [GET /v1/orders](https://docs.layout.link/api#get-v1-orders).

## Breaking changes

None. Every change adds a field, an event or an endpoint.
