---
title: "List withdrawals"
method: GET
path: "/api/v2/wallet/withdrawals"
tags: ["Withdrawals"]
---

# List withdrawals

`GET /api/v2/wallet/withdrawals`

The user's most recent withdrawals (up to 20), newest first, across every rail. Poll this to reflect status changes in your UI; `completed` and `rejected` are terminal and also emailed to the user.

## Query parameters

- `user_id` string, required

## Response `200`

The list.

- object
  - `object` 'list'
  - `data` Withdrawal[]
    - `object` 'withdrawal'
    - `id` string — Withdrawal id (`wd_...`).
    - `user_id` string
    - `status` 'requested' | 'processing' | 'completed' | 'rejected'
    - `rail` 'bank' | 'address' — `bank` pays a saved recipient by wire; `address` sends USDC on Base to the supplied address.
    - `amount_cents` integer
    - `destination_address` string, nullable — Set on the `address` rail: the Base address receiving USDC.
    - `failure_code` string, nullable — Set when rejected, e.g. `rejected_by_ops`.
    - `completed_at` string, date-time, nullable
    - `created_at` string, date-time
    - `recipient` WithdrawalRecipient — A saved bank destination. Account and IBAN numbers are always masked to their last four digits in responses.
      - `object` 'withdrawal_recipient'
      - `user_id` string — The connected user this destination belongs to.
      - `id` string — Recipient id (`wrec_...`). Pass it as `recipient_id` when creating a withdrawal.
      - `type` 'ach' | 'international_wire'
      - `nickname` string, nullable
      - `beneficiary_name` string
      - `country_code` string — ISO 3166-1 alpha-2 country of the bank account.
      - `currency` string, nullable
      - `bank_name` string, nullable
      - `account_number_last4` string, nullable — Masked, ACH only. Example: `••••6789`.
      - `routing_number` string, nullable — ACH only.
      - `account_type` 'checking' | 'savings', nullable
      - `iban_last4` string, nullable — Masked, international wire only.
      - `swift_code` string, nullable — International wire only.
      - `created_at` string, date-time

## Other responses

- `404` — `connection_not_found`.

---

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