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.

LevelDailyMonthlyLifetimePayment methods
Level 1USD 2,999USD 2,999USD 2,999Debit card only
Level 2USD 9,999USD 299,970No limitAll
Level 3USD 50,000USD 1,000,000No limitAll

  • 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.

Did this page help you?