Data Requirements

The data required for each user depends on the type of regulated activity they want to perform, the KYC tier that applies, and the user’s residency.

KYC Tiers for On/Offramp

On/offramp verification is progressive. Crossmint applies a KYC tier based on cumulative transaction volume, transaction frequency, and risk profile, so a user does not have to provide the full data set up front for low-value activity.

Tier	Applies when	What is required
Progressive (light) KYC	Up to $1,000 in total volume in the last 12 months and a low transaction count	`userDetails` and `kycData` only
Full KYC	Transacting over the progressive (light) KYC limits	Progressive KYC data plus `dueDiligence`, `verificationHistory`, an identity document, and a selfie
Enhanced Due Diligence (EDD)	Requested only for high-risk profiles	Full KYC data plus proof of address; proof of income may also be requested

Verification status is reported per tier: onramp-light / offramp-light for the progressive tier and onramp / offramp for the full tier. See Onramp user onboarding and Offramp KYC & compliance for how and when each tier applies to each product, including regional differences.

Progressive (light) KYC is available for both the embedded (client-side) flow and the import-KYC-data (server-side) API flow. Availability can vary by region.

Requirements for non-US residents

The following tables show what information is required for each activity type and tier for users residing outside the United States. To see the specific fields required for each object follow the Create User API documentation.

Object	Payouts	On/offramp (progressive)	On/offramp (full)
userDetails	✅	✅	✅
kycData		✅	✅
dueDiligence			✅
verificationHistory			✅

Document Requirements

No documents are required for progressive (light) KYC. Documents are only requested once a user reaches the Full KYC tier. Use the Upload Document API to upload the necessary materials.

Document Type	On/offramp (full)	On/offramp with EDD*
Identity document	✅	✅
Selfie	✅	✅
Proof of address		✅
Proof of income		Only if requested

*Enhanced Due Diligence (EDD) is required for high-risk individuals or regions.

Under progressive (light) KYC an identity number may still be required inside kycData.identityDocument — an ID number for EU/EEA residents (optional for the rest of the world). This is a data field, not a document upload; passport, ID card, selfie, and other document uploads are only requested at the Full KYC tier.

Identity document types for non-US residents:

For residents of countries outside of EU/EEA, only passport (id-passport) is accepted. Driving licenses or local ID cards are not accepted.
For residents of EU/EEA countries, passport (id-passport), ID cards (id-idcard-front, id-idcard-back), or residency permit (id-residency-permit, Spain residents only) are accepted.

Requirements for US residents

There are no KYC tiers for US residents: the required data does not change with transaction volume. What is required depends on the user’s state of residence.