Customer Levels
What each Graded Onboarding level needs, what it allows, and how a customer moves up.
How Levels Work
Levels make limits more flexible. Instead of verifying every customer for the highest limits, each individual customer has a level, and you move a customer up only when they need to transfer more. A higher level needs more information and allows higher limits.
- Level 1: a quick start for US residents. Debit card only, up to USD 2,999 in total.
- Level 2: full verification, in or outside the US. All payment methods, up to USD 9,999 a day.
- Level 3: higher limits after a manual review.
Requirements by Level
The information you send for each level.
Level 1 (US residents only):
- Nationality and state.
Level 2 (in or outside the US):
- Full address, occupation and purpose of use.
- An identity document, such as a passport or driver's license.
- SSN for US residents, or a local tax number for everyone else.
- Phone number.
Level 3:
- Level 2 first.
- A short reason for the higher limits. Harbor's compliance team reviews it.
For the full requests, see Onboard an Individual (V2) and Upgrade a Level.
Limits by Level
How much a customer can transfer at each level, and with which payment methods.
| Level | Daily | Monthly | Lifetime | Payment methods |
|---|---|---|---|---|
| Level 1 | USD 2,999 | USD 2,999 | USD 2,999 | Debit card only |
| Level 2 | USD 9,999 | USD 299,970 | No limit | All |
| Level 3 | USD 50,000 | USD 1,000,000 | No limit | All |
- Level 1: the USD 2,999 is one allowance for the customer's whole time at Level 1. Once it's used, the customer needs Level 2.
- Level 3: the amounts are defaults. Harbor sets the limits for each customer during the review, between USD 1,000 and 250,000 a day, and between USD 10,000 and 5,000,000 a month.
Each transfer must also fit the customer type and payment method limits. See Transfer Limits.
Move Up a Level
A customer moves up one level at a time.
- Level 1 to Level 2: send the Level 2 information. While it's reviewed, the customer can't transfer.
- Level 2 to Level 3: send a short reason. The customer can keep transferring at Level 2 during the review. You can send one Level 3 request every 7 days.
For the requests, see Upgrade a Level.
Customers Without a Level
Some customers aren't onboarded with Graded Onboarding, or aren't verified yet.
- Business customers: they have no level, so level limits don't apply.
- Customers who aren't verified yet: they have no level. A Graded Onboarding customer can't transfer until they have one.
Check a Customer's Level
The customer's level is in kyc_level:
GET /api/v2/customers/{customer_uuid}/individual/onboarding
{
"data": {
"status": "verified",
"kyc_level": 1,
"next_level": 2,
"transfers_blocked": false,
"rfi_link": null,
"pending_requirements": []
}
}next_level is the level the customer can upgrade to next. This endpoint is for Graded Onboarding customers only. For a Standard Onboarding customer, it returns error code 2309, so use the webhooks below.
When the level changes, Harbor sends the customer.kyc_level.changed webhook event. kyc_level is also in every customer webhook for individuals. It isn't in the customer response from the Customers API.
Notes
- Level 1 is for US residents only. Customers outside the US start at Level 2.
- In Sandbox, customers that are verified automatically don't get a level. To test levels, see Test in Sandbox.
Updated about 1 month ago