# List statistics

URL: https://docs.hanzo.ai/docs/openapi/team/get-team-transactor-statistics

> Returns the transactor's live sessions for the space the caller's credential names — the endpoint the front's space switcher and server panel poll on the transactor base.

`GET /v1/team/transactor/statistics`

> [Team →](https://docs.hanzo.ai/docs/openapi/team) · [All API references →](https://docs.hanzo.ai/docs/openapi) · [Get started →](https://docs.hanzo.ai/docs/guides)

|               |                                                      |
| ------------- | ---------------------------------------------------- |
| **Address**   | `https://api.hanzo.ai/v1/team/transactor/statistics` |
| **Method**    | `GET`                                                |
| **Operation** | `get_team_transactor_statistics`                     |
| **Auth**      | `Authorization: Bearer $HANZO_API_KEY`               |

Returns the transactor's live sessions for the space the caller's
credential names — the endpoint the front's space switcher and server panel
poll on the transactor base. `token` carries the same two lanes the socket's path
segment does: a space UUID names the space and is authorized against the
membership rows, an HS256 space token names it in its signed claims.
activeSessions carries ONLY that one space, never another tenant's sessions.
An unverifiable credential, or one the caller is no member under, is 401.

## Request

1 field.

| Field   | In    | Type   | Required | Description                                         |
| ------- | ----- | ------ | -------- | --------------------------------------------------- |
| `token` | query | string | —        | Token is the space token minted by selectWorkspace. |

## Response

| Status    | Body            | Meaning |
| --------- | --------------- | ------- |
| `200`     | team.statsOut   | ok      |
| `default` | problem-details | refused |

`200` body — 6 fields.

| Field                                  | In   | Type               | Always | Description                                                           |
| -------------------------------------- | ---- | ------------------ | ------ | --------------------------------------------------------------------- |
| `admin`                                | body | boolean            | —      | Admin is the upstream service's server-panel flag, always false here. |
| `metrics`                              | body | object             | —      | Metrics is the upstream transactor's metrics block.                   |
| `statistics`                           | body | team.statsSessions | —      |                                                                       |
| `statistics.activeSessions`            | body | object             | —      | ActiveSessions maps a space uuid to its connected sessions.           |
| `statistics.activeSessions.*`          | body | team.statsUser\[]  | —      |                                                                       |
| `statistics.activeSessions.*[].userId` | body | string             | —      | UserID is the account the session is authenticated as.                |

Failure carries the platform error shape — see [Errors](https://docs.hanzo.ai/docs/errors).

## Examples

**CLI**

```bash
hanzo team transactor statistics
```

**SDK**

**.ts**

```ts
import { Configuration, TeamApi } from 'hanzoai';

const api = new TeamApi(new Configuration({ accessToken: process.env.HANZO_API_KEY }));
const { data } = await api.getTeamTransactorStatistics();
```

**.py**

```python
from hanzoai.cloud import ApiClient, Configuration
from hanzoai.cloud.api import TeamApi

client = ApiClient(Configuration(access_token=os.environ["HANZO_API_KEY"]))
result = TeamApi(client).get_team_transactor_statistics()
```

**.go**

```go
cfg := hanzoai.NewConfiguration()
cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY"))
client := hanzoai.NewAPIClient(cfg)

resp, _, err := client.TeamAPI.GetTeamTransactorStatistics(context.Background()).Execute()
if err != nil {
	return err
}
```

**.rs**

```rust
use hanzo_client::apis::{configuration::Configuration, team_api};

let mut cfg = Configuration::new();
cfg.bearer_access_token = std::env::var("HANZO_API_KEY").ok();

let result = team_api::get_team_transactor_statistics(&cfg, Default::default()).await?;
```

**.java**

```java
import ai.hanzo.cloud.ApiClient;
import ai.hanzo.cloud.api.TeamApi;

ApiClient client = new ApiClient();
client.setBearerToken(System.getenv("HANZO_API_KEY"));

var result = new TeamApi(client).getTeamTransactorStatistics();
```

**HTTP**

```bash
curl https://api.hanzo.ai/v1/team/transactor/statistics \
  -H "Authorization: Bearer $HANZO_API_KEY"
```

**MCP**

MCP reaches **team** through the `team` tool, which names its 33 operations with its own verbs — this one among them, under a name only MCP declares. `describe` explains any of them:

```bash
curl -X POST https://api.hanzo.ai/v1/mcp \
  -H "Content-Type: application/json" \
  -d '{
       "jsonrpc": "2.0",
       "id": 1,
       "method": "tools/call",
       "params": {
         "name": "describe",
         "arguments": {
           "op": "list_team_account_providers"
         }
       }
     }'
```

---

[Team API](https://docs.hanzo.ai/docs/openapi/team) · [All Hanzo APIs](https://docs.hanzo.ai/docs/openapi) · [Interactive reference](https://docs.hanzo.ai/docs/openapi/reference)