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

# get_onboarding_session

> Check a hosted onboarding session: pending (email not yet proven), verified (consent pending), completed (cardholder_id is set), or expired.

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

Check a hosted onboarding session: pending (email not yet proven), verified (consent pending), completed (cardholder\_id is set), or expired. email is the address the user actually verified.

## Inputs

| Field                     | Type   | Description             |
| ------------------------- | ------ | ----------------------- |
| `session_id` *(required)* | string | The session id (cos\_…) |

## Returns

| Field                  | Type   | Description                                  |
| ---------------------- | ------ | -------------------------------------------- |
| `message` *(required)* | string | Human-readable status.                       |
| `status`               | string | pending \| verified \| completed \| expired. |
| `cardholderId`         | string | Set once completed.                          |
| `email`                | string | The verified email, once proven.             |

## Example call

```json theme={null}
{
  "tool": "get_onboarding_session",
  "arguments": {
    "session_id": "\u2026"
  }
}
```