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

# List orders

> Paginated list of your off-ramp orders, newest first, filterable by status.

Lists your orders, newest first.

## Endpoint

```text theme={null}
GET https://merchant.minisend.xyz/api/offramp/orders
```

```text theme={null}
Authorization: Bearer ms_live_your_key_here
```

Requires the `offramp` scope.

## Query parameters

<ParamField query="status" type="string">
  Filter by status: `pending`, `settling`, `completed`, `failed`, or `expired`.
</ParamField>

<ParamField query="limit" default="20" type="number">
  Page size, max 100.
</ParamField>

<ParamField query="offset" default="0" type="number">
  Rows to skip.
</ParamField>

## Example

```bash theme={null}
curl "https://merchant.minisend.xyz/api/offramp/orders?status=completed&limit=50" \
  -H "Authorization: Bearer ms_live_your_key_here"
```

## Response (200)

```json theme={null}
{
  "orders": [
    {
      "order_id": "9b2f6c1e-...",
      "status": "completed",
      "amount_usdc": 10,
      "currency": "KES",
      "settlement_receipt": "SHQ1234ABC",
      "created_at": "2026-07-05T12:00:03.000Z"
    }
  ],
  "total": 132,
  "limit": 50,
  "offset": 0
}
```

<ResponseField name="orders" type="array" required>
  Full [order objects](/api-reference/offramp/get-order).
</ResponseField>

<ResponseField name="total" type="number" required>
  Total rows matching the filter. Use with `limit`/`offset` to paginate.
</ResponseField>