---
title: "Get withdrawal statuses"
method: GET
path: "/get-withdrawal-status"
---

# Get withdrawal statuses

`GET /get-withdrawal-status`

## Request

- Base URL: `https://laso.finance`
- URL: `https://laso.finance/get-withdrawal-status`
- Auth: API key in header `Authorization`

Returns the status of withdrawals for the authenticated user. If `withdrawal_id` is provided, returns a single withdrawal. If omitted, returns all withdrawals.

Requires a Bearer token from `/auth` or `/get-card`.

## Query parameters

- `withdrawal_id` string

## Response `200`

Withdrawal status. Returns `{ "withdrawal": WithdrawalStatus }` when `withdrawal_id` is provided, or `{ "withdrawals": WithdrawalStatus[] }` when omitted.

- union
  - object
    - `withdrawal` WithdrawalStatus: A withdrawal status record.
      - `id` string
      - `amount` number
      - `asset` string
      - `network` string
      - `state` string
      - `address` string: The wallet address the withdrawal is sent to
      - `timestamp` number
      - `timestamp_readable` string
      - `tx_hash` string: On-chain transaction hash, present once the withdrawal is processed
      - `tx_url` string: Block explorer URL for the transaction, present when tx_hash exists
  - object
    - `withdrawals` WithdrawalStatus[]
      - `id` string
      - `amount` number
      - `asset` string
      - `network` string
      - `state` string
      - `address` string: The wallet address the withdrawal is sent to
      - `timestamp` number
      - `timestamp_readable` string
      - `tx_hash` string: On-chain transaction hash, present once the withdrawal is processed
      - `tx_url` string: Block explorer URL for the transaction, present when tx_hash exists

## Other responses

- `401`: Missing or invalid Bearer token
- `403`: Account is frozen. The response includes a `frozen_message` field explaining why.
- `404`: Withdrawal not found

---

[API](https://skmtc.dev/laso/apis/laso-finance-x402-api.md) · [All operations](https://skmtc.dev/laso/apis/laso-finance-x402-api/llms.txt) · [OpenAPI document](https://skmtc.dev/laso/apis/laso-finance-x402-api/revisions/ff8ce20b49ba?raw)