Skip to main content
The Topper API lets you share the KYC of your users with Topper, 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.
  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 endpoints for each missing process, with the data you already collected. For identity, the token can also upload the documents with Files.
KYC sharing must be enabled for your organization. Contact your Account Manager to set it up.