# VerifyYou

## Docs

- [Introduction](https://docs.verifyyou.com/v3/introduction.md): Verify a real, unique human in two calls, from the browser or your server.
- [Humanness and uniqueness](https://docs.verifyyou.com/v3/concepts/humanness-and-uniqueness.md): How we prove someone is a live human, then prove they're the only one.
- [Members vs guests](https://docs.verifyyou.com/v3/concepts/members-vs-guests.md): Everyone starts as a device. A verified identity gives a person a claim to their own uniqueness.
- [Returning users](https://docs.verifyyou.com/v3/concepts/returning-users.md): How a verified human is recognized the next time they come through.
- [init()](https://docs.verifyyou.com/v3/sdk/init.md): Configure the SDK once and choose how the flow appears: redirect, drawer, or inline.
- [vycheck()](https://docs.verifyyou.com/v3/sdk/vycheck.md): Start a verification from the browser, as a redirect or an embedded flow.
- [vyget()](https://docs.verifyyou.com/v3/sdk/vyget.md): Read the verification result, from the return URL or the last embedded flow.
- [POST /v3/initialize](https://docs.verifyyou.com/v3/api/initialize.md): Mint a verification session and get back a hosted URL to send the user to.
- [GET /v3/confirmations/{token}](https://docs.verifyyou.com/v3/api/confirmations.md): Exchange a return token for the authoritative verification result.
- [Account linking](https://docs.verifyyou.com/v3/advanced/account-linking.md): Tie a verification to your own user, and bind an identity that claims their uniqueness.
- [API reference & spec](https://docs.verifyyou.com/v3/openapi.md): Where to find every endpoint. Browse it, try it, or generate a client.
- [FAQ](https://docs.verifyyou.com/v3/faq.md): Common questions about verifying, keys, returning users, and data.
- [Changelog](https://docs.verifyyou.com/v3/changelog.md): What's new in the VerifyYou SDK, API, and docs.
- [Initialize a verification session](https://docs.verifyyou.com/api-reference/verification-flow/initialize-a-verification-session.md): Initialize a session before the user verifies and get back a hosted verification link with a queued-up session. Redirect the user to the returned `url`; they come back to the redirect URL configured on the verification with `?vyt=<token>&vyc=<0|1>`, which you confirm server-side at `GET /v3/confirma…
- [Confirm a verification token](https://docs.verifyyou.com/api-reference/confirmations/confirm-a-verification-token.md): Exchange the `vyt` token the user returned with for the authoritative verification result. **Secret key only.** Call this from your backend before granting access.
- [Lock a confirmation](https://docs.verifyyou.com/api-reference/confirmations/lock-a-confirmation.md): Permanently retire this person's confirmation on this verification. **Secret key only.** This is **person-level and permanent — not token single-use.** The lock lands on the confirmation the token points at, not on the token, and a returning user's later passes fold onto that same confirmation, so e…
- [Test an API key](https://docs.verifyyou.com/api-reference/api-keys/test-an-api-key.md): Check that an API key works and see what it is: publishable or secret, test or live, and which company it belongs to. Send the key as the bearer token, like any other call. Always returns `200`: a bad key comes back as `valid: false` rather than an error, so it's safe to wire into a healthcheck or s…

## OpenAPI Specs

- [openapi](https://docs.verifyyou.com/v3/openapi.json)