# KayWhySee

> Identity verification: an ID document and a live selfie, captured on the customer's phone and checked on our servers.

## Guides: Get started
- [Introduction](https://www.kaywhysee.com/docs/introduction): Identity verification from an ID document and a selfie video captured on the user's phone.
- [Quickstart](https://www.kaywhysee.com/docs/quickstart): Create a session, complete it on a phone and retrieve the result.
- [Authentication](https://www.kaywhysee.com/docs/authentication): Secret keys, publishable keys and scopes.

## Guides: Core concepts
- [How verification works](https://www.kaywhysee.com/docs/how-it-works): The capture flow and the checks run on each submission.
- [Sessions and statuses](https://www.kaywhysee.com/docs/sessions): Session lifecycle, statuses, references and expiry.
- [Results and outcomes](https://www.kaywhysee.com/docs/results): The outcome, reasons and captures fields.
- [Privacy and data](https://www.kaywhysee.com/docs/privacy): Data stored per session, encryption and retention.

## Guides: Integrate
- [Verify button](https://www.kaywhysee.com/docs/verify-button): An embeddable button that creates a session with a publishable key.
- [Hosted links](https://www.kaywhysee.com/docs/hosted-links): Single-use links from the dashboard and reusable links for verify buttons.
- [Webhooks](https://www.kaywhysee.com/docs/webhooks): Event delivery to your endpoints.
- [Sandbox](https://www.kaywhysee.com/docs/sandbox): Sandbox keys, simulated sessions and outcomes, for development and CI.
- [Errors](https://www.kaywhysee.com/docs/errors): Error format, codes and retries.
- [Rate limits](https://www.kaywhysee.com/docs/rate-limits): Request limits and handling 429 responses.

## Guides: Code examples
- [Node.js](https://www.kaywhysee.com/docs/examples/node): Express app that creates a session and reads the result.
- [Python](https://www.kaywhysee.com/docs/examples/python): Flask app that creates a session and reads the result.
- [Verify button page](https://www.kaywhysee.com/docs/examples/button): Standalone HTML page with a verify button.

## API reference: Overview
- [API reference](https://www.kaywhysee.com/docs/api-reference/introduction): Base URL, authentication, request and response formats.

## API reference: Sessions
- [Create a session](https://www.kaywhysee.com/docs/api-reference/sessions/create): Creates a session and returns its start_url.
- [Retrieve a session](https://www.kaywhysee.com/docs/api-reference/sessions/retrieve): Returns a session by ID.
- [Cancel a session](https://www.kaywhysee.com/docs/api-reference/sessions/cancel): Cancels a session that hasn't ended.
- [Simulate a session](https://www.kaywhysee.com/docs/api-reference/sessions/simulate): Ends a sandbox session with the outcome you choose. Sandbox keys only.
- [The session object](https://www.kaywhysee.com/docs/api-reference/sessions/object): Fields returned by every session endpoint.

## API reference: Verify buttons
- [Retrieve a button](https://www.kaywhysee.com/docs/api-reference/buttons/retrieve): Returns a verify button's public configuration. No key required.
- [Start from a button](https://www.kaywhysee.com/docs/api-reference/buttons/start): Creates a session from a verify button with a publishable key.

## API reference: Webhooks
- [Webhook events](https://www.kaywhysee.com/docs/api-reference/webhooks/events): Events sent to webhook endpoints.