# List withdrawals

**GET /api/v1/withdrawals**

Returns the authenticated user's withdrawal history. Pagination, sorting, date filtering, and status filtering parameters are reserved for this list endpoint; current responses remain unpaginated until server-side pagination is enabled.


## Servers
- https://api.staging.lumepay.com: https://api.staging.lumepay.com ()



## Parameters
### Headers

- **X-API-KEY** (string)
  Public API key issued from the Lumepay API key management flow.

- **X-API-SECRET** (string)
  API secret paired with the public API key.



### Query parameters

- **page** (integer(int32))
  Page number, zero-based.

- **size** (integer(int32))
  Page size. Planned maximum: 100.

- **sort** (string)
  Sort expression: field,direction.

- **dateFrom** (string(date-time))
  Reserved inclusive lower timestamp bound.

- **dateTo** (string(date-time))
  Reserved inclusive upper timestamp bound.

- **status** (string)
  Reserved withdrawal status filter.



## Responses
### 200
Withdrawals returned successfully

#### Body: application/json (array[object])
- **amount** (number)
  Withdrawal amount.

- **fee** (number)
  Withdrawal fee.

- **currency** (string)
  Withdrawal currency code.

- **withdrawDetails** (object)

- **status** (string)
  Withdrawal status.

- **transactionId** (string)
  Transaction id for withdrawal lookups.

- **createdAt** (string(date-time))
  Withdrawal creation timestamp.

- **completedAt** (string(date-time))
  Completion timestamp.

- **isFiat** (boolean)
  Whether this withdrawal used a fiat route.


### 429
Cloudflare API rate limit exceeded

#### Body: application/json (object)
- **error** (string)

- **message** (string)


### 403
Authenticated API key is not allowed to perform this action

#### Body: application/json (object)
- **code** (integer(int32))

- **message** (string)

- **httpStatus** (integer(int32))

- **requestId** (string)

- **timestamp** (string(date-time))

- **errors** (array[object])


### 500
Unexpected server error

#### Body: application/json (object)
- **code** (integer(int32))

- **message** (string)

- **httpStatus** (integer(int32))

- **requestId** (string)

- **timestamp** (string(date-time))

- **errors** (array[object])


### 400
Request validation failed

#### Body: application/json (object)
- **code** (integer(int32))

- **message** (string)

- **httpStatus** (integer(int32))

- **requestId** (string)

- **timestamp** (string(date-time))

- **errors** (array[object])


### 401
API key authentication failed

#### Body: application/json (object)
- **code** (integer(int32))

- **message** (string)

- **httpStatus** (integer(int32))

- **requestId** (string)

- **timestamp** (string(date-time))

- **errors** (array[object])



[Powered by Bump.sh](https://bump.sh)