> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plerion.com/llms.txt
> Use this file to discover all available pages before exploring further.

# plerion tenant

> Get tenant information and usage details.

With **plerion tenant**, you can retrieve tenant information including the organization name, risk score, and resource usage details.

***

## Synopsis

```bash theme={"system"}
plerion tenant <subcommand>
```

***

## Subcommands

### get

```bash theme={"system"}
plerion tenant get
```

Returns tenant ID, organization ID, name, risk score, and timestamps.

### get-usage

```bash theme={"system"}
plerion tenant get-usage [--date <yyyy-MM-dd>]
```

Returns tenant usage details. Supports all output formats (table, json, yaml, text).

| Option   | Type   | Description                                           |
| -------- | ------ | ----------------------------------------------------- |
| `--date` | string | Usage date in `yyyy-MM-dd` format (defaults to today) |

***

## Examples

```bash theme={"system"}
# Get tenant info as a table
plerion tenant get

# Get tenant info as JSON
plerion tenant get --output json

# Extract just the risk score
plerion tenant get --output json --query 'data.riskScore'

# Get usage details as a table
plerion tenant get-usage

# Get usage for a specific date
plerion tenant get-usage --date 2025-03-01 --output json
```

***

## Output columns (get)

| Column     | Description        |
| ---------- | ------------------ |
| TENANT ID  | Tenant ID          |
| ORG ID     | Organization ID    |
| NAME       | Tenant name        |
| RISK SCORE | Numeric risk score |
| CREATED AT | Creation timestamp |
| UPDATED AT | Update timestamp   |

## Output columns (get-usage)

| Column       | Description                       |
| ------------ | --------------------------------- |
| ASSETS       | Number of assets in the tenant    |
| INTEGRATIONS | Number of integrations configured |

### Example output (JSON)

```json theme={"system"}
{
  "data": {
    "tenantId": "t-abc123",
    "organizationId": "org-xyz",
    "name": "Acme Corp",
    "riskScore": 7.2,
    "createdAt": "2024-01-15T10:30:00Z",
    "updatedAt": "2024-06-01T14:00:00Z"
  }
}
```