---
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`

## Request

- Base URL: `https://api.bridge.xyz/v0`
- URL: `https://api.bridge.xyz/v0/customers/{customerID}/card_accounts/{cardAccountID}/withdrawals`
- Auth: API key in header `Api-Key`

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.dev/bridge/apis/bridge-api.md) - [All operations](https://skmtc.dev/bridge/apis/bridge-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bridge/apis/bridge-api/revisions/a390532e9fc6?raw)