---
title: "Get withdrawal request"
method: GET
path: "/withdrawals/requests/{id}"
tags: ["Withdrawals"]
---

# Get withdrawal request

`GET /withdrawals/requests/{id}`

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

## Path parameters

- `id` string, required

## Headers

- `X-SCX-SIGNED` string, required
- `X-SCX-TIMESTAMP` string, required

## Response `200`

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

- GetWithdrawalRequestResponse
  - `message` WithdrawalRequestEntity[]
    - `id` string, uuid — Unique identifier (UUID v4) for the withdrawal request.
    - `withdrawal_account_id` number — The ID of the whitelisted withdrawal account or address the funds were sent to.
    - `participant_code` string — The participant the request belongs to, e.g. ABCDEF.
    - `beneficiary_participant_code` string, nullable — The participant code of the beneficiary when the withdrawal is being made on behalf of another participant. Null for standard withdrawals.
    - `sender_participant_code` string, nullable — The participant code of the sender when the request was initiated on behalf of a third party. Null for standard withdrawals.
    - `requestor_participant_code` string — The participant code of the platform or participant that initiated the request, e.g. ABCDEF.
    - `requested_amount` string — The initially requested amount, e.g. 100.10.
    - `settled_amount` string, nullable — The settled amount. This can be less than or equal to the requested_amount. Null while the withdrawal is still in an APPROVED state.
    - `status` 'PENDING' | 'APPROVED' | 'REJECTED' | 'SETTLED' — The current status of the withdrawal request.
    - `asset` 'AAVE.ETH' | 'ADA' | 'ALGO' | 'AVAX' | 'BAT.ETH' | 'BCH' | 'BTC' | 'BUSD.ETH' | 'COMP.ETH' | 'DAI.ETH' | 'DOGE' | 'DOT' | 'EGLD' | 'EOS' | 'ETC' | 'ETH' | 'ETH.ARBITRUM' | 'GRT.ETH' | 'GYEN.ETH' | 'HBAR' | 'LINK.ETH' | 'LTC' | 'LUNA' | 'MATIC.ETH' | 'MATIC.POLYGON' | 'MKR.ETH' | 'MOB' | 'SAND.ETH' | 'SOL' | 'UNI.ETH' | 'USDC.ETH' | 'USDC.ALGO' | 'USDC.POLYGON' | 'USDC.SOL' | 'USDC.HBAR' | 'USDC.XLM' | 'USDC.AVAX' | 'USDT.ETH' | 'UST' | 'WBTC.ETH' | 'XEM' | 'XLM' | 'XRP' | 'XTZ' | 'ZUSD.ETH' — The asset code for the request, e.g. `BTC`.
    - `account_group` string — The account group the request was made against, e.g. 00SCXM for the Seed Digital Commodities Market account group.
    - `account_label` string, nullable — The account label associated with the account. Null when the request targets the default (unlabeled) account.
    - `transaction_id` string, nullable — The on-chain transaction hash once the withdrawal has been broadcast. Null until the transaction has been sent to the network.
    - `input_data` string, nullable — Applicable only for smart-contract executions on the Ethereum blockchain. The ABI encoding of the function and its arguments in RLP format. Null for standard transfers.
    - `requested_timestamp` number — Unix timestamp in milliseconds for when the withdrawal request was last updated. Changes with status updates.
    - `created_timestamp` string, date-time — RFC 3339 / ISO 8601 timestamp (UTC) of when the withdrawal request was originally created. Immutable.
    - `gas_price` string, nullable — The transaction fee payable on the Ethereum network. Null when the asset is not an ERC-20 token or when the fee was not client-supplied.
    - `client_withdrawal_request_id` string, nullable — A unique identifier for the withdrawal, generally produced by the Platform on which the trade was executed. Must be unique per platform per 24-hour period. Null when not provided by the client.
    - `on_chain_status` 'PENDING' | 'CONFIRMED' | 'null', nullable — Indicates whether the crypto withdrawal has been confirmed on-chain. Null for fiat withdrawals or while the request is still APPROVED and has not been broadcast.
    - `fee_amount` string, nullable — The network fee (denominated in the network fee asset) associated with the withdrawal. Null until the fee has been determined.
    - `withdrawal_fee` string, nullable — The withdrawal fee (denominated in the withdrawn asset) charged by zerohash. Returned as an empty string or null when no withdrawal fee applies.
    - `quoted_fee_amount` string, nullable — The fee paid by the customer in crypto terms as quoted. Null when the withdrawal did not go through the quoted-fee flow.
    - `quoted_fee_notional` string, nullable — The fee paid by the customer in USD terms as quoted. Null when the withdrawal did not go through the quoted-fee flow.
    - `quoted_fee_asset` string, nullable — The asset in which the quoted fee was charged. Null when the withdrawal did not go through the quoted-fee flow.
    - `trade_id` string, uuid, nullable — When a fee-locked `trade_id` was supplied on the withdrawal request, the associated trade identifier. Null otherwise.
    - `parent_link_id` string, nullable — Identifier linking this withdrawal to a parent request (for example a convert-and-withdraw quote execution). Null for standalone withdrawals.
    - `parent_link_id_source` string, nullable — The source context of the `parent_link_id` when present. Null when `parent_link_id` is null.
    - `amount_in_usd` number, nullable — Indicative USD value of the withdrawal at the time the record was returned. Present on list responses for all consumers; conditionally omitted on single-request responses for non-portal origins.
    - `contract_validation_id` string, uuid, nullable — Identifier of the EVM smart-contract execution validation record linked to the withdrawal. Null unless the withdrawal targets a validated contract call.
    - `recipient_instructions` string, nullable — Recipient instructions for this withdrawal request (e.g. wire memo). Returns the request-level memo if provided, otherwise the account default, or null when none is set.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/zerohash/apis/zerohash-api.md) · [All operations](https://skmtc.net/zerohash/apis/zerohash-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zerohash/zerohash-api/revisions/8b647d934363/schema)