Get withdrawal | Lumetrade Staging API documentation

Get withdrawal Run in API Explorer

GET /api/v1/withdrawals/{transactionId}

Returns a single withdrawal belonging to the authenticated API key owner.

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.

Path parameters

transactionId string Required

Withdrawal transaction id returned by the withdrawal list endpoint.

Responses

200 application/json

Withdrawal 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.
404 application/json

Withdrawal was not found for the authenticated user
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/{transactionId}

curl \
 --request GET 'https://api.lumetrade.com/api/v1/withdrawals/wd_5M8Q1P' \
 --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
}

Response examples (404)

{
  "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
}