> ## Documentation Index
> Fetch the complete documentation index at: https://docs.balaipedia.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List orders

> List and filter your orders.

Newest first. Only orders from the last 60 days are returned.

## Query parameters

**limit** `integer` (default: 20)

1-100, default 20. Values above 100 are clamped to 100.

**cursor** `integer`

Pass the `next_cursor` of the previous page. An invalid cursor returns `400`.

**status** `string`

One of `pending`, `processing`, `success`, `error`. An unknown value returns `400`.

**reference** `string`

Only orders with exactly this reference.

**email** `string`

Only orders for this buyer email.

## Pagination

Pass `next_cursor` as `cursor` to get the next page. `next_cursor` is `null` when `has_more` is false. When nothing matches you get `{"object":"list","data":[],"has_more":false,"next_cursor":null}`.

```bash curl theme={null}
curl "https://orders.balaipedia.com/v1/orders?status=error&limit=50" \
  -H "Authorization: Bearer YOUR_KEY"
```

```json 200 OK theme={null}
{"object":"list","data":[ ...orders... ],"has_more":true,"next_cursor":1234}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.