> ## 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.

# list_recoveries

> List headroom recoveries (residual cardholder spending power pulled back into the company wallet), newest first.

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

**Behavior:** read-only.

## What it does

List headroom recoveries (residual cardholder spending power pulled back into the company wallet), newest first. Filter by status: requested, processing, completed, rejected.

## Inputs

| Field    | Type                                                          | Description                       |
| -------- | ------------------------------------------------------------- | --------------------------------- |
| `status` | string: `requested` · `processing` · `completed` · `rejected` | Status filter                     |
| `limit`  | number                                                        | Max results (default 25, max 100) |

## Returns

| Field                  | Type    | Description                                                        |
| ---------------------- | ------- | ------------------------------------------------------------------ |
| `message` *(required)* | string  | Human-readable summary.                                            |
| `recoveries`           | array   | Recovery objects (id, status, amount\_cents, cardholder\_id, ...). |
| `hasMore`              | boolean | Whether more pages exist.                                          |

## Example call

```json theme={null}
{
  "tool": "list_recoveries",
  "arguments": {}
}
```