# List Withdrawals

> 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 withdrawals, newest first.

## Overview

- `purpose`: `off_ramp` (paid for a sale of stablecoin), `on_ramp` (a stablecoin delivery of a pay-in) or `treasury`.

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

## Endpoint

### `GET /v1/ramp/bank/customer/withdrawals`

Authentication: bearer token required.

The user's withdrawals, 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` Withdrawals

```json
{
  "environment": "production",
  "withdrawals": [
    {
      "id": "9a2c4e6f-1b3d-4a5c-8e7f-0d2b4c6e8a10",
      "environment": "production",
      "purpose": "off_ramp",
      "attempt": 1,
      "retryOf": null,
      "asset": "KES",
      "amount": "20000.00",
      "sourceAsset": "KES",
      "sourceAmount": "20000.00",
      "fee": "150.00",
      "rate": null,
      "destinationType": "momo",
      "destination": {
        "institutionId": "mpesa-ke",
        "mobileNumber": "+2547•••••678",
        "beneficiaryName": "J•• W••••"
      },
      "status": "pending",
      "failureCode": null,
      "sentAt": "2026-10-23T09:00:02.000Z",
      "completedAt": 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/#local-withdrawals