> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hifi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# KYB
> To comply with financial regulations, HIFI enforces KYB (Know Your Business) checks before a business User can receive funds from fiat (onramps), pay out to fiat (offramps), or access other financial products offered by HIFI.
## Components of a KYB Application
A KYB application consists of information about the business itself and each of its associated parties.
* Profile
* Documentation
* Questionnaire
Each UBO or control person requires their own:
* Profile
* Documentation
## Information Required
Different information is required for verification, including both non-documentary and documentary checks. For business users, associated party and ultimate beneficial owner (UBO) information is required in addition to the company information.
### Profile
| Field | Description | Required |
| :-------------------- | :-------------------------------------------------------------------- | :------- |
| `businessName` | Legal name of the business | Yes |
| `businessDescription` | Description of the business activities | Yes |
| `email` | Contact email address | Yes |
| `phoneNumber` | Phone number with country code | Yes |
| `businessType` | Legal entity type (e.g. LLC, CORPORATION) | Yes |
| `businessIndustry` | Industry code of the business | Yes |
| `registrationNumber` | Business registration number | Yes |
| `incorporationDate` | Date of business incorporation | Yes |
| `physicalAddress` | Business address (line1, city, state, postalCode, country) | Yes |
| `taxId` | Tax identification number (e.g. EIN for US businesses) | Yes |
| `taxIdType` | Tax identification number (e.g. SSN, ITIN) | Yes |
| `taxIdCountry` | Tax identification number issuance country | Yes |
| `registeredAddress` | Registered business address (line1, city, state, postalCode, country) | Yes |
| `website` | Business website | Yes |
### Documentation
For more details check [Documents](/v3/core/compliance/documents)
| Document Group | Accepted Type | Required |
| :------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------- |
| `legalPresence` | `INCORPORATION_ARTICLES`, `INCORPORATION_CERT`, `STATE_REGISTRY` | Yes |
| `ownershipStructure` | `SHAREHOLDER_REGISTRY`, `TRUST_AGREEMENT`, `INFORMATION_STATEMENT`, `STATE_REGISTRY` | Yes |
| `controlStructure` | `DIRECTORS_REGISTRY`, `TRUST_AGREEMENT`, `INFORMATION_STATEMENT`, `STATE_REGISTRY` | Yes |
| `companyDetails` | `UTILITY_BILL`, `BANK_STATEMENT`, `RENTAL_AGREEMENT`, `TAX_DOCUMENT`, `VOTER_REGISTRATION_CARD`, `BANK_REFERENCE_LETTER`, `LEASE_OR_TENANCY_AGREEMENT`, `PROOF_OF_ADDRESS` | Yes |
A single document can be used to fulfill multiple document group requirements, for example, submitting a `STATE_REGISTRY` can fulfill `legalPresence`, `ownershipStructure`, and `controlStructure`.
`companyDetails` needs to be issued within the **last 3 months**
### Associated Parties
Each UBO or person with significant control of the business must be added as an associated party, with their own profile information and identity documentation. For the required fields and endpoint details, see [Associated Parties](/v3/core/compliance/associated-parties).
## Questionnaire
| Field | Description | Required |
| :--------------------------------- | :--------------------------------------------------------------------------------------------- | -------- |
| `annualRevenue` | The business's annual revenue in USD | Yes |
| `expectedMonthlyTransactionVolume` | Expected monthly transaction volume in USD | Yes |
| `expectedMonthlyTransactionCount` | Expected number of transactions per month | Yes |
| `primaryPurpose` | The business's primary purpose for using the platform | Yes |
| `primaryPurposeDetails` | Details about the primary purpose, if `primaryPurpose` is `other` | No\* |
| `highRiskActivities` | Any high-risk activities the business engages in | Yes |
| `sourceOfFunds` | The primary source of the business's funds | Yes |
| `sourceOfFundsDetails` | Details about the primary source of the business's funds, if `sourceOfFundsDetails` is `other` | No\* |
| `transmitsThirdPartyFunds` | Whether the business transmits funds on behalf of third parties | Yes |
| `transmitsThirdPartyFundsDetails` | Details about the nature of how the business transmits funds on behalf of third parties | No\* |
| `providesFinancialServices` | Whether the business provides financial services | Yes |
## Example: Full KYB Flow
Update the business's non-documentary information
**Request**
```shellscript theme={null}
curl -X PATCH "https://sandbox.hifi.com/v3/users/usr_8kL2MdPcfxmB6OyzXWQNr/compliance/profile" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"businessName": "Random Bizz",
"businessDescription": "move money",
"businessType": "corporation",
"businessIndustry": "423430",
"email": "new.random.bizz@hifibridge.com",
"website": "https://www.hifibridge.com",
"phoneNumber": "8522224412",
"physicalAddress": {
"addressLine1": "Example St 1.",
"city": "Hoboken",
"stateProvinceRegion": "NJ",
"postalCode": "07030",
"country": "USA"
},
"registeredAddress": {
"addressLine1": "Example St 1.",
"city": "Hoboken",
"stateProvinceRegion": "NJ",
"postalCode": "07030",
"country": "USA"
},
"registrationNumber": "99999999",
"taxId": "12345678",
"incorporationDate": "2021-01-22"
}'
```
**Response**
```json theme={null}
{
"userId": "usr_8kL2MdPcfxmB6OyzXWQNr",
"type": "BUSINESS",
"businessName": "Random Bizz",
"businessDescription": "move money",
"alternativeNames": null,
"businessType": "corporation",
"businessIndustry": "423430",
"website": "https://www.hifibridge.com",
"taxId": "****9068",
"taxIdType": null,
"taxIdCountry": null,
"registrationNumber": "****9999",
"leiNumber": null,
"formationDate": null,
"incorporationDate": "2021-01-22",
"email": "new.random.bizz@hifibridge.com",
"phoneNumber": "*******4412",
"physicalAddress": {
"addressLine1": "Example St 1.",
"addressLine2": null,
"city": "Hoboken",
"stateProvinceRegion": "NJ",
"postalCode": "07030",
"country": "USA"
},
"registeredAddress": {
"addressLine1": "Example St 1.",
"addressLine2": null,
"city": "Hoboken",
"stateProvinceRegion": "NJ",
"postalCode": "07030",
"country": "USA"
},
"postalAddress": null,
"createdAt": "2026-07-16T03:20:24.656Z",
"updatedAt": "2026-07-16T03:20:43.199Z"
}
```
Upload the documentation to fulfill the business `legalPresence`, `ownershipStructure`, `controlStructure` and `companyDetails` requirements
Use the File endpoint to upload the file first, then add the documentation to the user with the returned file ID (e.g. `file_xxxxxxxxxxxx`).
#### Business Documents
Add `STATE_REGISTRY`to fulfill `legalPresence`, `ownershipStructure`, `controlStructure`requirements.
**Request**
```shell theme={null}
curl -X POST "https://sandbox.hifi.com/v3/users/usr_8kL2MdPcfxmB6OyzXWQNr/compliance/documents" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "STATE_REGISTRY",
"subType": "SINGLE_SIDE",
"issuedCountry": "USA",
"fileId": "file_O8A1X7gCKoYxlb2aMYYzK"
}'
```
**Response**
```json theme={null}
{
"id": "doc_SRcWjbyyP3o6Fx643rxyM",
"userId": "usr_8kL2MdPcfxmB6OyzXWQNr",
"associatedPartyId": null,
"type": "STATE_REGISTRY",
"subType": "SINGLE_SIDE",
"issuedCountry": "USA",
"issuedDate": null,
"expiryDate": null,
"number": null,
"fileId": "file_O8A1X7gCKoYxlb2aMYYzK",
"description": null,
"isValid": null,
"message": null,
"createdAt": "2026-07-16T03:25:07.389Z",
"updatedAt": "2026-07-16T03:25:07.389Z"
}
```
Add `UTILITY_BILL`to fulfill `companyDetails` requirements.
**Request**
```shell theme={null}
curl -X POST "https://sandbox.hifi.com/v3/users/usr_8kL2MdPcfxmB6OyzXWQNr/compliance/documents" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "UTILIT_BILL",
"subType": "SINGLE_SIDE",
"issuedCountry": "USA",
"fileId": "file_9r3hAF930FHS3853"
}'
```
**Response**
```json theme={null}
{
"id": "doc_20450GHDGIEo6Fse3FE",
"userId": "usr_8kL2MdPcfxmB6OyzXWQNr",
"associatedPartyId": null,
"type": "UTILIT_BILL",
"subType": "SINGLE_SIDE",
"issuedCountry": "USA",
"issuedDate": null,
"expiryDate": null,
"number": null,
"fileId": "file_9r3hAF930FHS3853",
"description": null,
"isValid": null,
"message": null,
"createdAt": "2026-07-16T03:25:07.389Z",
"updatedAt": "2026-07-16T03:25:07.389Z"
}
```
**Request**
```shell theme={null}
curl -X PATCH "https://sandbox.hifi.com/v3/users/usr_8kL2MdPcfxmB6OyzXWQNr/compliance/questionnaire" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"annualRevenue": "250000000_plus",
"expectedMonthlyTransactionVolume": "20000000_plus",
"expectedMonthlyTransactionCount": "100000_plus",
"primaryPurpose": "other",
"primaryPurposeDetails": "basd",
"highRiskActivities": [
"none"
],
"sourceOfFunds": "operating_revenue",
"transmitsThirdPartyFunds": false,
"providesFinancialServices": true
}'
```
**Response**
```json theme={null}
{
"userId": "usr_8kL2MdPcfxmB6OyzXWQNr",
"type": "BUSINESS",
"annualRevenue": "250000000_plus",
"expectedMonthlyTransactionVolume": "20000000_plus",
"expectedMonthlyTransactionCount": "100000_plus",
"highRiskActivities": [
"none"
],
"primaryPurpose": "other",
"primaryPurposeDetails": "basd",
"sourceOfFunds": "operating_revenue",
"sourceOfFundsDetails": null,
"providesFinancialServices": true,
"transmitsThirdPartyFunds": false,
"transmitsThirdPartyFundsDetails": null,
"createdAt": "2026-07-16T03:20:24.597Z",
"updatedAt": "2026-07-16T03:35:53.249Z"
}
```
Add each UBO or person with significant control of the business, then keep the returned `associatedPartyId` - you'll need it to attach their identity documentation in the next step.
**Request**
```shell theme={null}
curl -X POST "https://sandbox.hifi.com/v3/users/usr_8kL2MdPcfxmB6OyzXWQNr/compliance/associated-parties" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"businessTitle": "CEO",
"roles": [
"UBO"
],
"firstName": "William",
"lastName": "Yang",
"dateOfBirth": "1955-03-22",
"email": "bob@hifi.com",
"phoneNumber": "8574839944",
"gender": "M",
"physicalAddress": {
"addressLine1": "Example St 1.",
"addressLine2": "Apt 123",
"city": "Hoboken",
"stateProvinceRegion": "NJ",
"postalCode": "12345",
"country": "USA"
},
"taxId": "38493888",
"relationshipEstablishedAt": "2022-03-22",
"nationality": "USA",
"shareProportion": 30
}'
```
**Response**
```json theme={null}
{
"id": "ap_PafbCNYpvOBnkr1U01BYI",
"userId": "usr_8kL2MdPcfxmB6OyzXWQNr",
"type": "INDIVIDUAL",
"roles": [
"UBO"
],
"businessTitle": "CEO",
"firstName": "William",
"middleName": null,
"lastName": "Yang",
"nationality": "USA",
"email": "bob@hifi.com",
"phoneNumber": "*******9944",
"physicalAddress": {
"addressLine1": "Example St 1.",
"addressLine2": "Apt 123",
"city": "Hoboken",
"stateProvinceRegion": "NJ",
"postalCode": "12345",
"country": "USA"
},
"dateOfBirth": "1955-03-22",
"gender": "M",
"taxId": "****3888",
"taxIdType": "SSN",
"taxIdCountry": "USA",
"relationshipEstablishedAt": "2022-03-22",
"shareProportion": 30,
"createdAt": "2026-07-16T03:37:23.681Z",
"updatedAt": "2026-07-16T03:37:23.681Z"
}
```
See [Associated Parties](/v3/core/compliance/associated-parties) for more details
Upload the documentation to fulfill the associated party `identity` and `proofOfResidence` requirements
Use the File endpoint to upload the file first, then add the documentation to the user with the returned file ID (e.g. `file_xxxxxxxxxxxx`).
#### Government Issued ID
**Request**
```shellscript theme={null}
curl -X POST "https://sandbox.hifi.com/v3/users/usr_8kL2MdPcfxmB6OyzXWQNr/compliance/associated-parties/ap_PafbCNYpvOBnkr1U01BYI/documents" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "PASSPORT",
"subType": "SINGLE_SIDE",
"issuedCountry": "USA",
"fileId": "file_O8A1X7gCKoYxlb2aMYYzK"
}'
```
**Response**
```json theme={null}
{
"id": "doc_lPeFxGI2dAVFvLV2g7b33",
"userId": "usr_8kL2MdPcfxmB6OyzXWQNr",
"associatedPartyId": "ap_PafbCNYpvOBnkr1U01BYI",
"type": "PASSPORT",
"subType": "SINGLE_SIDE",
"issuedCountry": "USA",
"issuedDate": null,
"expiryDate": null,
"number": null,
"fileId": "file_O8A1X7gCKoYxlb2aMYYzK",
"description": null,
"isValid": null,
"message": null,
"createdAt": "2026-07-13T22:13:44.870Z",
"updatedAt": "2026-07-13T22:13:44.870Z"
}
```
If the document has two sides, submit both, using `FRONT_SIDE` and `BACK_SIDE` for the `subType`.
#### Proof of Address
**Request**
```shellscript theme={null}
curl -X POST "https://sandbox.hifi.com/v3/users/usr_8kL2MdPcfxmB6OyzXWQNr/compliance/associated-parties/ap_PafbCNYpvOBnkr1U01BYI/documents" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "UTILITY_BILL",
"subType": "SINGLE_SIDE",
"issuedCountry": "USA",
"fileId": "file_ofidSSDFHS7538ffbje9"
}'
```
**Response**
```json theme={null}
{
"id": "doc_lPeFxGI2dAVFvLV2g7b33",
"userId": "usr_8kL2MdPcfxmB6OyzXWQNr",
"associatedPartyId": "ap_PafbCNYpvOBnkr1U01BYI",
"type": "UTILITY_BILL",
"subType": "SINGLE_SIDE",
"issuedCountry": "USA",
"issuedDate": null,
"expiryDate": null,
"number": null,
"fileId": "file_ofidSSDFHS7538ffbje9",
"description": null,
"isValid": null,
"message": null,
"createdAt": "2026-07-13T22:13:44.870Z",
"updatedAt": "2026-07-13T22:13:44.870Z"
}
```
For US and Canadian users, if a driver's license, national ID, or resident permit has already been submitted as the government-issued ID, no additional proof of address is needed.
Once all the required information is updated, submit the application for compliance review
**Request**
```shellscript theme={null}
curl -X PATCH "https://sandbox.hifi.com/v3/users/usr_8kL2MdPcfxmB6OyzXWQNr/compliance/check" \
-H "Authorization: Bearer YOUR_API_KEY"
```
**Response**
```json theme={null}
{
"userId": "usr_8kL2MdPcfxmB6OyzXWQNr",
"complianceStatus": "PENDING",
"message": null,
"rfiActions": []
}
```
Listen to our webhook or poll the user's compliance status
**Request**
```shell theme={null}
curl -X GET "https://sandbox.hifi.com/v3/users/usr_8kL2MdPcfxmB6OyzXWQNr/compliance/status" \
-H "Authorization: Bearer YOUR_API_KEY"
```
**Response**
```json theme={null}
{
"userId": "usr_8kL2MdPcfxmB6OyzXWQNr",
"complianceStatus": "APPROVED",
"message": null,
"rfiActions": []
}
```
## Expected Behavior
After submission, the application has the following possible states:
No additional action is needed — the user has already passed HIFI's compliance check.
**What's next:**
Wait for corridor functionality to be unlocked for the user. The timing may vary, and based on the customer profile, the user may not be eligible for all corridors.
No action required — the information has been uploaded and is awaiting processing.
The application is currently under review by our compliance team.
**What you can expect:**
* An RFI may be sent to your compliance mailbox requesting additional information
* The status may move to `REQUIRES_INFO` after our compliance check — use GET `/v3/users/:user_id/compliance/status` to see what additional information is required
* The status may move to `REJECTED` or `APPROVED` when a final decision is made by our compliance team
* A verification link may be included in the `rfiActions` field when a liveness check is required for an associated party with type `COMPLETE_LIVENESS_CHECK`.
**Example**
```json theme={null}
{
"userId": "usr_V3leEgLs3FJ4jcI7rfPWJ",
"complianceStatus": "IN_REVIEW",
"message": null,
"rfiActions": [
{
"type": "COMPLETE_LIVENESS_CHECK",
"message": "Please complete the liveness check via verification link",
"verificationLink": "https://in.sumsub.com/websdk/p/sbx_iNZi5pTWEjmzOPEQ",
"associatedPartyId": "ap_tIFGUMSVnyUrkc68kPqtV"
}
]
}
```
KYB reviews typically take longer than individual KYC due to the additional entity and associated party verification.
Our compliance team has determined that we cannot onboard this user. Reach out to our support team for more information.
Our compliance team has requested updates to the applicant's data before resubmission. Common reasons include: a mismatched address on the proof of address, blurry documentation, an incorrectly formatted document, or incomplete associated party information.
For more details, check the `rfiActions` field after calling GET `/v3/users/:user_id/compliance/status`.
**Example**
```json theme={null}
{
"userId": "usr_8kL2MdPcfxmB6OyzXWQNr",
"complianceStatus": "REQUIRES_INFO",
"message": "The ownership information provided does not match the shareholder register.",
"rfiActions": [
{
"type": "UPDATE_PROFILE",
"associatedPartyId": "apt_kF9sLm2QwXcVbN3yTzR8p",
"fields": [
"ownershipPercentage"
],
"message": "Please update the ownership percentage to match the shareholder register."
},
{
"type": "UPDATE_PROFILE",
"fields": [
"registrationNumber"
],
"message": "Please update the business registration number to match the document."
},
{
"type": "UPLOAD_DOCUMENT",
"message": "Please upload a complete shareholder register including all pages.",
"documentId": "doc_pu0aoLYYTST8xxewiyblK"
},
{
"type": "UPLOAD_DOCUMENT",
"associatedPartyId": "apt_kF9sLm2QwXcVbN3yTzR8p",
"message": "Please upload a complete shareholder register including all pages.",
"documentId": "doc_puDSeif893FEyblK"
}
]
}
```
**Breaksdown**
For the above example, there are 2 update requirements for the business information — these come in objects that do not include an `associatedPartyId`:
* `UPDATE_PROFILE`: registrationNumber
* `UPLOAD_DOCUMENT`: `doc_pu0aoLYYTST8xxewiyblK`
On top of that, there are also 2 update requirements for the associated party `apt_kF9sLm2QwXcVbN3yTzR8p` that needs updates:
* `UPDATE_PROFILE`: ownershipPercentage
* `UPLOAD_DOCUMENT`: `doc_puDSeif893FEyblK`
Update the information, then use POST `/v3/users/:user_id/compliance/submit` to submit the application again.
## RFI Actions
When a submitted application needs updated information, the `rfiActions` field will include the actions required before resubmission.
| Type | Action |
| :------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `UPDATE_PROFILE` | Update the business's or associated party's profile information before resubmission, a common reason is information that doesn't match the submitted documentation. |
| `RESUBMIT_DOCUMENT` | Update the business's or associated party's documentation before resubmission, common reasons include expired, blurry, or unqualified documents. |
| `UPDATE_QUESTIONNAIRE` | Update the business's questionnaire before resubmission |
| `COMPLETE_LIVENESS_CHECK` | Complete the required liveness check for each associated party via provided verification link. |
A `COMPLETE_LIVENESS_CHECK` action is currently issued when the status is `IN_REVIEW`.
## Getting Help
* 📧 **Email:** [support@hifi.com](mailto:support@hifi.com)
* 💬 **Slack:** Message us in our shared Slack channel
## Related Resources
* [User Overview](/v3/core/users/overview) - User types and creation
* [KYC (Individual)](/v3/core/compliance/kyc) - Individual verification requirements
* [Associated Parties](/v3/core/compliance/associated-parties) - UBO and control person requirements
* [Virtual Accounts](/v3/core/orchestration/virtual-accounts) - Set up fiat deposit accounts
* API Reference: Complete endpoints