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.

Headers

  • X-API-KEY string Required

    Public API key issued from the Lumetrade API key management flow.

  • X-API-SECRET string Required

    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 application/json

    Withdrawals returned successfully

    Hide response attributes Show response attributes object
    • amount number

      Withdrawal amount.

    • fee number

      Withdrawal fee.

    • currency string

      Withdrawal currency code.

    • withdrawDetails object

      Raw withdrawal details stored as JSON object.

      Additional properties are allowed.

      Hide withdrawDetails attributes Show withdrawDetails attributes object
      • pojo boolean
      • int boolean
      • double boolean
      • bigDecimal boolean
      • bigInteger boolean
      • nodeType string

        Values are ARRAY, BINARY, BOOLEAN, MISSING, NULL, NUMBER, OBJECT, POJO, or STRING.

      • container boolean
      • short boolean
      • long boolean
      • valueNode boolean
      • missingNode boolean
      • floatingPointNumber boolean
      • integralNumber boolean
      • string boolean
      • boolean boolean
      • object boolean
      • textual boolean Deprecated
      • binary boolean
      • number boolean
      • array boolean
      • empty boolean
      • null boolean
      • float boolean
      • embeddedValue boolean
    • status string

      Withdrawal status.

      Values are PENDING, ACCEPTED, AWAITING_CONFIRMATION, PROCESSING, COMPLIANCE_PENDING, COMPLETED, FAILED, CANCELLED, or REVERSED.

    • 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.

GET /api/v1/withdrawals
curl \
 --request GET 'https://api.lumetrade.com/api/v1/withdrawals' \
 --header "X-API-KEY: string" \
 --header "X-API-SECRET: string"
Response examples (200)
[
  {
    "amount": 101,
    "fee": 1,
    "currency": "ZAR",
    "withdrawDetails": {
      "bankName": "FNB",
      "accountNumber": "1234567890"
    },
    "status": "COMPLETED",
    "transactionId": "wd_5M8Q1P",
    "createdAt": "2026-05-11T10:15:30Z",
    "completedAt": "2026-05-11T10:20:30",
    "isFiat": true
  }
]