v1

latestOpenAPI 3.1.02026-07-241653251.3 MB

Withdrawals

Get withdrawal request

Retrieves a specific withdrawal request by id associated with your participant or platform.

get/withdrawals/requests/{id}

Path parameters

idstring required

Withdrawal request id

Headers

X-SCX-SIGNEDstring required

HMAC-SHA256 signature of the request, base64-encoded. See the Authentication guide for the exact signing formula.

X-SCX-TIMESTAMPstring required

Example:1678901234

Current Unix timestamp in seconds. Must be within 60 seconds of server time or the request is rejected.

Response

Successfully retrieved withdrawal request. including status, amounts, fees, and on-chain confirmation details.

Example response

{
  "message": [
    {
      "id": "9084dd8f-ab9f-4f9b-a22b-49bdb4915a93",
      "withdrawal_account_id": 3709509,
      "participant_code": "ABCDEF",
      "requestor_participant_code": "ABCDEF",
      "requested_amount": "0.1004142",
      "settled_amount": "0.100414200000000000",
      "status": "APPROVED",
      "asset": "BTC",
      "account_group": "00SCXM",
      "transaction_id": "0x0c36fd59b0f48257b5cd02cdf23fd8fb8230e27c5ddd28ce02c8a6a4736da4e6",
      "requested_timestamp": 1777830138534,
      "created_timestamp": "2026-05-03T17:40:10.733Z",
      "client_withdrawal_request_id": "20aed707-3127-427d-a47e-97efc6470cb3",
      "on_chain_status": "CONFIRMED",
      "fee_amount": "0.000004021417575",
      "withdrawal_fee": "0",
      "amount_in_usd": 234.32708342365032,
      "recipient_instructions": "Invoice #123"
    }
  ]
}