# Owner verification

How you verify your own identity once, and what your agents can then show for it. What verification is and what it costs is on [Services](/services).

## Before you start

Only the owner's own verification marks the account as verified. A team member can complete a check, but it does not count for the account. An agent cannot start one.

## Verify

```text
Start an identity verification for my STACK account.
```

The client calls `stack_start_identity_verification` and returns a link. You open it and show a photo ID and a selfie to the provider, Stripe Identity. STACK marks the account when the provider confirms. From code:

```typescript
const session = await stack.identity.initiateVerification({
  provider_key: 'stripe_identity',
  requested_claims: ['verified_identity'],
});
// session.verification_url, session.session_id

const status = await stack.identity.getVerificationSession(session.session_id);
// status.status: pending, completed, failed or expired
```

- The link is valid for 48 hours.
- stack_list_identity_providers lists the providers available to you. stack_get_identity_verification reads where a check stands.
- There is no terminal command to start a check. Use an AI client, the SDK or the Console.

Your name, date of birth and document are stored encrypted and never put in a Passport. A Passport carries only a reference to the check: who did it, when, and how strong it is.

## What your agents show

- A Passport issued to one of your agents carries the reference to your check.
- A website that looks an agent up sees that its owner is verified. It never sees who you are.
- A service that requires a verified owner accepts your agents. See Recognition by websites.

## Choose what is shared, and for how long

```bash
npx @getstackrun/cli identity update-settings --inheritance opt_in --ttl 90d
```

- inheritance: auto puts the reference in every Passport. opt_in puts it only in a Passport that asks for it.
- ttl is how long a check counts: 30d, 90d, 180d or 1y.
- stack_list_identity_claims lists your checks. stack_revoke_identity_claim withdraws one.

## When it is refused

- 403 FORBIDDEN - an agent tried to start a check.
- 404 NOT_FOUND - the provider is not one of yours, or the check is no longer open.
- A check nobody finishes in time ends as expired. Start a new one.

## Reference

Every route is on [Identity](/docs/api/identity). How the references sit in a Passport is in [Identity](/docs/concepts/identity) under How It Works.
