KYB Overview

Every business must clear Know Your Business verification before it can transact or hold API keys. It is completed in the app, through the KYB WebSDK launch.

What verification covers

Step	What the business provides
Company details	Legal name, country, registration number, incorporation date, legal address, tax id, and legal form.
Registry documents	Certificate of incorporation, articles of incorporation, certificate of good standing, ownership structure chart, share registry, directors registry or certificate of incumbency, power of attorney for its representatives, and proof of address.
Incorporation and compliance detail	The deed and notary record behind the incorporation, any later amendment to the bylaws, tax registration, recent financial statements, and any license, AML policy, or compliance officer the business is required to hold.
Corporate information letter	Its business model, website, the jurisdictions it operates in, its economic activity, and a transactional profile: expected annual amount, number and type of operations, channels and assets used, and counterparties.
Source of funds	Where the funds the business will use originate, with bank or financial statements behind the declaration.
Agreements	Electronic signature, the terms and conditions, and the customer agreement.
Owners and representatives	The people it names as its beneficial owners, each with the size of their stake, and as its legal representatives. Each of them completes an identity check of their own.
Parent companies	A company that owns part of the business is added as a parent company, and supplies its country, legal name, registration number, and the size of its stake, plus its certificate of incorporation, certificate of good standing, ownership structure chart, directors registry or certificate of incumbency, and share registry. Parent companies can have their own parent companies.

A business is approved once it, its owners, its representatives, and its parent companies have all been reviewed and approved.

Treat the list above as informational rather than as a contract. Etherfuse tunes what is required by jurisdiction and risk, and adding a requirement changes what your customer is asked for, not your integration.

Tracking verification status

The overall status

curl -H "Authorization: <api_key>" \
  https://api.sand.etherfuse.com/ramp/organization/<organization_uuid>/kyb/status

curl -H "Authorization: <api_key>" \
  https://api.etherfuse.com/ramp/organization/<organization_uuid>/kyb/status

{
  "organizationId": "00000000-0000-4000-8000-000000000001",
  "status": "submitted",
  "approvedAt": null
}

Status	Description
`not_started`	No verification started
`in_progress`	Started, but the business still has something to submit, including a note Etherfuse has asked it to answer
`submitted`	Everything the business can do is done; Etherfuse’s turn, including a note the business is waiting on an answer to
`approved`	Cleared; the business can transact
`denied`	A rejected verdict, or a previously-approved business whose approval was revoked

GET /ramp/organization/{id}/kyb/status returns the same shape the webhook delivers.

The status change webhook

Subscribe to the kyb_updated webhook. It fires whenever a business’s KYB status changes and carries the organizationId, the new status, and approvedAt, so you learn the moment verification is approved or needs attention without anyone watching the app. It fires on status changes only, never on individual document or answer edits.

The organizationId identifies the business. A person is identified separately by their customerId, the sub you sign into their JWT. The two are never interchangeable.

When a customer created their own business and you only hold their sub, GET /ramp/customer/{customer_id}/organization lists the businesses they belong to, so you can find its organizationId.

Get Started

Concepts

User Authentication

Integration Guides

KYC

KYB

Blockchains

Resources

What verification covers

Tracking verification status

The overall status

The status change webhook

​What verification covers

​Tracking verification status

​The overall status

​The status change webhook

What verification covers

Tracking verification status

The overall status

The status change webhook