STACK
MENU
DOCS / THE ACCOUNT / OWNER VERIFICATION

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.

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

prompt
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. How the references sit in a Passport is in Identity under How It Works.

Owner verification | Docs