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

# vetta identity legal

> Verify a persona's people and form a company from the command line.

Legal resources belong to a [persona](https://vetta.sh/docs/cli/identity.md), so every command takes `--identity`. Reached as `vetta identity legal <command>` — three words, where `legal` is a sub-group rather than a positional argument. See [Legal](https://vetta.sh/docs/identity/legal.md) for the model and the [Legal API](https://vetta.sh/docs/api/legal.md) for the wire shapes.

## Commands

| Command | Description |
| - | - |
| `vetta identity legal verifications` | List the persona's verification cases. |
| `vetta identity legal verify` | Start a verification case for one or more members. |
| `vetta identity legal verification` | Read one case with its members. |
| `vetta identity legal complete` | Complete a member with the token from the hosted page. |
| `vetta identity legal resend` | Mint a fresh hosted link for a member. |
| `vetta identity legal companies` | List the persona's companies. |
| `vetta identity legal form` | Form a company from a verified case (debits credits). |
| `vetta identity legal company` | Read one company. |
| `vetta identity legal submit` | File a paid company. |
| `vetta identity legal documents` | List a company's documents. |
| `vetta identity legal document` | Mint a short-lived link to one document. |
| `vetta identity legal naics` | Search industry (NAICS) codes. |
| `vetta identity legal states` | List the states a company can be formed in, with fees. |

`--identity` takes either an `idn_` id or the persona's name; the API resolves both. On a deployment with no legal provider bound, every command answers `501 feature_not_configured`.

## verify

```bash theme={"system"}
vetta identity legal verify --identity ava --members '[{"first_name":"Ava","last_name":"Stone","email":"ava@example.com","role":"primary","is_responsible_party":true,"ownership_percent":100}]'
```

| Flag | Description |
| - | - |
| `--members` | JSON array of members (required). Exactly one `primary`, exactly one responsible party, ownership summing to 100. |

The members are validated locally before the request; a malformed list exits `2`. Prints the case; the primary member's `link_url` is set on this response only.

## verifications / verification / complete / resend

```bash theme={"system"}
vetta identity legal verifications --identity ava --limit 20
vetta identity legal verification --identity ava --verification lgv_…
vetta identity legal complete --identity ava --verification lgv_… --member lgm_… --token <token>
vetta identity legal resend --identity ava --verification lgv_… --member lgm_…
```

| Flag | Description |
| - | - |
| `--verification` | The `lgv_` id (required on the single-case commands). |
| `--member` | The `lgm_` id (required on `complete` and `resend`). |
| `--token` | The token the hosted page returns (required on `complete`). |
| `--limit` / `--after` | Pagination. |

## form

```bash theme={"system"}
vetta identity legal form --identity ava --company '{"verification_id":"lgv_…","state":"WY","name_options":["Acme Labs"],"naics_code":"541511","description":"Software consulting","mailing_address":{"line1":"1 Main St","line2":null,"city":"Cheyenne","state":"WY","postal_code":"82001","country":"US"}}'
```

| Flag | Description |
| - | - |
| `--company` | JSON body of the formation (required); validated locally. A bad field exits `2` naming it (`usage: --company: state — …`). |

The fee is debited from the organization's credits before anything is filed; a short balance answers `402 insufficient_credits` — the code is the first line on stderr and the exit code is `1`, as for every API refusal.

## companies / company / submit / documents / document

```bash theme={"system"}
vetta identity legal companies --identity ava
vetta identity legal company --identity ava --company lgc_…
vetta identity legal submit --identity ava --company lgc_…
vetta identity legal documents --identity ava --company lgc_…
vetta identity legal document --identity ava --company lgc_… --document lgd_…
```

| Flag | Description |
| - | - |
| `--company` | The `lgc_` id (required). |
| `--document` | The `lgd_` id (required on `document`). |
| `--limit` / `--after` | Pagination. |

## naics / states

```bash theme={"system"}
vetta identity legal naics --q software
vetta identity legal states
```

| Flag | Description |
| - | - |
| `--q` | Search text for `naics`. |
| `--limit` / `--after` | Pagination. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.