> ## 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](/docs/cli/identity), 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](/docs/identity/legal) for the model and the [Legal API](/docs/api/legal) 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.              |