# Principal

URL: https://docs.hanzo.ai/docs/cli/principal

> The `hanzo principal` commands.

Also for this capability: [API](https://docs.hanzo.ai/docs/openapi/principal) · **CLI** · [MCP](https://docs.hanzo.ai/docs/mcp-tools/principal) · [SDKs](https://docs.hanzo.ai/docs/sdks)

Serves an org as an economic principal: who it is, what it may pay, and which agents answer to it.

[API reference →](https://docs.hanzo.ai/docs/openapi/principal)

```bash
hanzo principal clearance list
```

Every command takes `--json` for the raw response and `--help` for its own flags. Sign in once with `hanzo auth login`; the commands below use that session, and the org they act in is the one it carries.

| Command                | What it does                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `hanzo principal get`  | Returns the caller's org as an economic principal, composed from the apps that own each fact: its legal entity and founders' identity verification (company), the W-9 or W-8 it certified (tax), its wallets (wallet), the agents that answer to it — spawned ones with the agent that spawned them — (agents), its screening against the OFAC, UN, EU and UK sanctions lists and the embargoed jurisdictions, run now, and what it still lacks to pay and be paid. |
| `hanzo principal keys` | Publishes the keys attestations are signed with, as a JSON Web Key Set (RFC 7517; Ed25519 keys as RFC 8037 writes them).                                                                                                                                                                                                                                                                                                                                            |

### Agents

| Command                            | What it does                                                                                                                                                                                                                        |
| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `hanzo principal agents get <ref>` | Attests which principal one of the caller's agents answers to: the org, the chain of agents that spawned it, and the same signed with the platform's key as a JWS (EdDSA) a verifier checks offline against GET /v1/principal/keys. |

### Clearance

| Command                              | What it does                                                                                                                                                                                                                 |
| ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `hanzo principal clearance create`   | Decides whether the caller's org may pay another org, BEFORE the payment: what must happen first, what must be withheld and why, what must be reported, by whom and when, and how the payment may settle net of withholding. |
| `hanzo principal clearance get <id>` | Reads one of the caller org's clearances, as it was decided.                                                                                                                                                                 |
| `hanzo principal clearance list`     | Lists the caller org's clearances, newest first, 200 at most; a payee narrows them.                                                                                                                                          |

### Statements

| Command                               | What it does                                                                                                     |
| ------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| `hanzo principal statements get <id>` | Reads whether one statement the platform signed about an agent still stands: live, expired, or revoked and when. |