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

> List your organization's cardholders in this mode, 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 your organization's cardholders in this mode, newest first.

## Inputs

| Field    | Type   | Description                       |
| -------- | ------ | --------------------------------- |
| `limit`  | number | Max results (default 50, max 100) |
| `offset` | number | Pagination offset (default 0)     |

## Returns

| Field                  | Type   | Description                                                                 |
| ---------------------- | ------ | --------------------------------------------------------------------------- |
| `message` *(required)* | string | Human-readable summary.                                                     |
| `cardholders`          | array  | Cardholder objects: id, firstName, lastName, email, phoneNumber, createdAt. |
| `total`                | number | Total cardholders in this mode.                                             |

## Example call

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