---
title: "Retrieve the withdrawal history of funds"
method: GET
path: "/customers/{customerID}/card_accounts/{cardAccountID}/withdrawals"
tags: ["Cards"]
---

# Retrieve the withdrawal history of funds

`GET /customers/{customerID}/card_accounts/{cardAccountID}/withdrawals`

Retrieve the withdrawal history of funds, applicable to top-up accounts only

## Path parameters

- `customerID` string, required — A UUID that uniquely identifies a resource
- `cardAccountID` string, required — A UUID that uniquely identifies a resource

## Query parameters

- `limit` integer
- `starting_after` string
- `ending_before` string

## Response `200`

The withdrawal history

- object
  - `count` integer, required — The number of withdrawals returned
  - `data` CardWithdrawal[], required
    - `id` string, required — A UUID that uniquely identifies a resource
    - `card_account_id` string, required — A UUID that uniquely identifies a resource
    - `customer_id` string, required — A UUID that uniquely identifies a resource
    - `amount` string, required — The amount represented as a decimal string
    - `type` 'top_up_balance_withdrawal' | 'fee' — The type of the withdrawal. Defaults to `top_up_balance_withdrawal`.
    - `currency` 'usdc', required
    - `destination` CardWithdrawalDestination, required
      - `chain` string, required — The chain of the wallet the withdrawn crypto funds should be transferred to
      - `address` string, required — The address of the wallet the withdrawn crypto funds should be transferred to
      - `memo` string — The memo to attach to the withdrawal transaction. Will be transmitted for blockchains that support memos only.
      - `tx_hash` string — The crypto transaction hash for the withdrawal once it's confirmed on the chain
      - `gas_fee` GasFee — The gas fee for a crypto transaction
        - `amount` string, required — The amount of the gas fee represented as a decimal string
        - `currency` string, required — The currency of the gas fee.
    - `client_note` string — An optional client-provided note for the withdrawal
    - `created_at` string, required — Timestamp when the withdrawal was created, in ISO8601 format
    - `updated_at` string, required — Timestamp when the withdrawal was last updated, in ISO8601 format

## Other responses

- `401` — Missing or invalid API key
- `500` — Unexpected error. User may try and send the request again.

---

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