# List Desk Orders

> Coming soon, upon request — this feature is turned on for your tenant by the Aurea team. [Contact us](https://www.aureahub.com/contact)

The user's desk orders, newest first.

Called with the user's access token, in one environment (`isTestnet`). See [Bank Ramp: Desk Orders](https://docs.aureahub.com/docs/guide-bank-desk.md).

## Endpoint

### `GET /v1/ramp/bank/customer/desk/orders`

Authentication: bearer token required.

The user's desk orders, newest first.

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `isTestnet` | boolean | no | `true` for the sandbox; `false` or omitted for production |
| `limit` | integer | no | 1 to 100, default 20 |
| `offset` | integer | no | From 0, default 0 |

**Responses**

`200` Orders

```json
{
  "environment": "production",
  "orders": [
    {
      "id": "8f0a2c4e-6b8d-4f1a-a3c5-e7091b3d5f74",
      "environment": "production",
      "direction": "to_bank",
      "fromAsset": "USDT",
      "fromAmount": "300",
      "toAsset": "ETB",
      "toAmount": "41850.00",
      "rate": "139.50",
      "quoteExpiresAt": "2026-10-23T09:01:00.000Z",
      "beneficiary": {
        "name": "A•••• T•••••",
        "bankName": "Example Bank Ethiopia",
        "accountNumber": "••••5521"
      },
      "funding": null,
      "status": "processing",
      "failureCode": null,
      "proofRejectedReason": null,
      "refundStatus": null,
      "expiresAt": null,
      "createdAt": "2026-10-23T09:00:00.000Z",
      "updatedAt": "2026-10-23T09:00:02.000Z"
    }
  ],
  "limit": 20,
  "offset": 0
}
```

`403` No tenant

```json
{
  "statusCode": 403,
  "error": "ForbiddenError",
  "message": "This request needs a tenant: an admin token without one has no bank ramp customer.",
  "details": {
    "code": "TENANT_REQUIRED"
  }
}
```

---

Web version: https://docs.aureahub.com/#desk-orders