> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcard.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# recover_funds

> Recover a cardholder's residual company-funded spending power back into your company wallet — for users you won't fund again (for everyone else, closed-card ba…

Connect to `https://mcp.agentcard.sh/mcp` with your **organization credential** (`client_id` + `client_secret`, or the org access token).

## What it does

Recover a cardholder's residual company-funded spending power back into your company wallet — for users you won't fund again (for everyone else, closed-card balances net automatically against their next card). Omit amount\_cents to recover the full current headroom. Live recoveries are fulfilled by the AgentCard team and complete asynchronously (recovery.completed webhook); sandbox completes instantly. Supports an idempotency\_key.

## Inputs

| Field                        | Type   | Description                                                |
| ---------------------------- | ------ | ---------------------------------------------------------- |
| `cardholder_id` *(required)* | string | The cardholder whose headroom to recover                   |
| `amount_cents`               | number | Amount in cents; omit to recover the full current headroom |
| `idempotency_key`            | string | Optional key making retries safe (Stripe semantics)        |

## Returns

| Field                  | Type   | Description                                                    |
| ---------------------- | ------ | -------------------------------------------------------------- |
| `message` *(required)* | string | Human-readable outcome.                                        |
| `recovery`             | object | The recovery (id, status, amount\_cents, cardholder\_id, ...). |

## Example call

```json theme={null}
{
  "tool": "recover_funds",
  "arguments": {
    "cardholder_id": "\u2026"
  }
}
```