> ## Documentation Index
> Fetch the complete documentation index at: https://developer.uphold.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Topper API introduction

> Share the KYC your users already completed with you to Topper, so they can buy and sell crypto with the Topper Widget without verifying again.

The Topper API lets you share the KYC of your users with [Topper](https://developer.uphold.com/widgets/topper/introduction.md), the widget that lets them buy and sell crypto. Users who already verified their identity with you don't have to go through verification again when they use Topper.

## How it works

1. **Identify the user.** Find the user's Topper account by their email and country of residence, or create one if they don't have one yet. The request must include the user's IP in the `X-Uphold-User-Ip` [header](https://developer.uphold.com/rest-apis/headers.md#user-context).
2. **Start a KYC sharing session.** The session lists the KYC processes that the Topper user is still missing, such as `profile`, `address` or `identity`, and returns a user access token scoped to update only those processes. If nothing is missing, the KYC is already shared and no token is returned.
3. **Submit the missing processes.** With the user access token, call the Core API [KYC](https://developer.uphold.com/rest-apis/core-api/kyc/overview.md) endpoints for each missing process, with the data you already collected. For `identity`, the token can also upload the documents with [Files](https://developer.uphold.com/rest-apis/core-api/files/overview.md).

KYC sharing must be enabled for your organization. Contact your Account Manager to set it up.
