> ## 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"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.