These endpoints let you onboard and manage entity customers (businesses and other legal entities) on zerohash. Onboarding submits the entity's details and supporting documentation — along with information about its controlling persons and beneficial owners — so zerohash can run KYC/KYB and register the entity to hold balances and transact.
A typical flow looks like this:
- Create the entity with its business details and associated users (controlling persons and beneficial owners).
- Upload supporting documents (e.g. formation documents and proof of address).
- Update the entity or its users later if any details change.
- Review screening and verification results for the entity's controlling persons and beneficial owners.
Once created, the entity enters KYC/KYB review. You should confirm its status before enabling any product flows.
What you need to collect
Entity onboarding requires more than an individual, because zerohash must verify both the business itself and the people behind it.
All entities
- Business details — legal name, entity type, registration/tax identifiers, and registered address.
- Controlling persons and beneficial owners — each associated person may require their own identifying details and documents.
- Supporting documents — such as formation/incorporation documents and proof of the entity's address.
US-based entities
- A business
tax_id(e.g. EIN) is required.
EU and other non-US entities
- Document uploads are required, including identity documents for controlling persons/beneficial owners and proof of the entity's address.
In short: every entity needs its business details plus its controlling persons and beneficial owners; US entities require a business
tax_id, and non-US entities (including the EU) require supporting documents.
Onboarding & management
- Create an entity — Onboards a new entity customer by submitting its business details and associated users, and begins KYC/KYB.
- Upload entity documents — Uploads the entity's supporting documents and identity documents for its controlling persons and beneficial owners.
- Update an entity — Updates the details of an existing entity.
- Update an entity user — Updates the details of a specific user (controlling person or beneficial owner) associated with an entity.
Screening & verification
These endpoints return sensitive KYC/PII and screening data. They require enablement by the zerohash support team and are subject to a security review prior to enablement.
- Get sanctions screening info (controlling persons & beneficial owners) — Returns the sanctions/watchlist screening results for an entity's controlling persons and beneficial owners.
- Get full info (controlling persons & beneficial owners) — Returns the complete KYC/PII records for an entity's controlling persons and beneficial owners.