---
title: "Get withdrawal status"
method: GET
path: "/withdraw/status"
tags: ["Fund"]
---

# Get withdrawal status

`GET /withdraw/status`

Returns the current withdrawal status for the authenticated merchant. Requires `fund.withdraw` permission.

## Query parameters

- `request_id` string, uuid, required — Withdrawal request ID.

## Headers

- `Date` string
- `Authorization` string

## Response `200`

Standard response envelope

- union
  - GetWithdrawStatusEnvelope
    - `code` 0, required — Business code. `0` means success.
    - `message` string, required — Response message.
    - `data` GetWithdrawStatusResponse, required
      - `request_id` string, uuid, required — Withdrawal request ID.
      - `status` 'pending' | 'processing' | 'completed' | 'failed', required — Current withdrawal status.
      - `amount` string, required — Total amount deducted from the source account.
      - `fee` string, required — Legacy Gas fee field. New integrations should use `gas_fee` and `gas_fee_currency`.
      - `actual_amount` string, required — Actual amount sent on-chain in `token_type`.
      - `transaction_hash` string, required — On-chain transaction hash. Empty before submission.
      - `chain` string, required — Public chain name.
      - `token_type` string, required — Token type.
      - `source_currency` string, required — Source account currency.
      - `gas_fee` string, required — Customer-facing Gas fee charged for the withdrawal.
      - `gas_fee_currency` string, required — Currency of `gas_fee`.
      - `fx_fee` string, required — FX fee charged for a cross-currency withdrawal; zero for same-currency withdrawals.
      - `fx_fee_currency` string, required — Currency of `fx_fee`.
      - `fee_paid_by` 'PAYER' | 'BENEFICIARY', required — Fee liability, either `PAYER` or `BENEFICIARY`.
  - ErrorEnvelope
    - `code` integer, required — Non-zero business error code.
    - `message` string, required — Error details.
    - `data` object, nullable, required — Error responses return null.

## Other responses

- `400` — Invalid application request
- `401` — HMAC gateway validation or application authentication failed
- `403` — API key permission, IP whitelist, or endpoint policy rejected the request
- `404` — Withdrawal request was not found for the authenticated organization

## Changes

> 5 revisions in range; 2 could not be searched.

- **2026-08-21** `aeea9ba2172d` — 1 info
  - added the required property `oneOf[#/components/schemas/GetWithdrawStatusEnvelope]/allOf[subschema #2]/data/source_currency` to the response with the `200` status

[Change history](https://skmtc.dev/infini/apis/infini-fund-api/changes/withdraw/status/get.md)

---

[API](https://skmtc.dev/infini/apis/infini-fund-api.md) · [All operations](https://skmtc.dev/infini/apis/infini-fund-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/infini/infini-fund-api/revisions/a77090a3bdd5/schema)