HIFI Docs

Components of a KYB Application

A KYB application consists of information about the business itself and each of its associated parties.

Business

Profile
Documentation
Questionnaire

Associated Parties

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

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.

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 Compliance Profile

Update the business’s non-documentary informationRequest

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

{
    "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"
}

Add Busines Documentation

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_REGISTRYto fulfill legalPresence, ownershipStructure, controlStructurerequirements.Request

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

{
    "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_BILLto fulfill companyDetails requirements.Request

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

{
    "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"
}

Update Questionnaire

Request

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

{
    "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 Associated Party

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

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

{
    "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 for more details

Add Document for the Associated Party

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

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

{
    "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

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

{
    "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.

Submit compliance information for check

Once all the required information is updated, submit the application for compliance reviewRequest

curl -X PATCH "https://sandbox.hifi.com/v3/users/usr_8kL2MdPcfxmB6OyzXWQNr/compliance/check" \
      -H "Authorization: Bearer YOUR_API_KEY"

Response

{
    "userId": "usr_8kL2MdPcfxmB6OyzXWQNr",
    "complianceStatus": "PENDING",
    "message": null,
    "rfiActions": []
}

Get the KYB status

Listen to our webhook or poll the user’s compliance statusRequest

curl -X GET "https://sandbox.hifi.com/v3/users/usr_8kL2MdPcfxmB6OyzXWQNr/compliance/status" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
    "userId": "usr_8kL2MdPcfxmB6OyzXWQNr",
    "complianceStatus": "APPROVED",
    "message": null,
    "rfiActions": []
}

Expected Behavior

After submission, the application has the following possible states:

APPROVED

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.

PENDING

No action required — the information has been uploaded and is awaiting processing.

IN_REVIEW

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

{
    "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.

REJECTED

Our compliance team has determined that we cannot onboard this user. Reach out to our support team for more information.

REQUIRES_INFO

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

{
    "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"
        }
    ]
}

BreaksdownFor 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
💬 Slack: Message us in our shared Slack channel

User Overview - User types and creation
KYC (Individual) - Individual verification requirements
Associated Parties - UBO and control person requirements
Virtual Accounts - Set up fiat deposit accounts
API Reference: Complete endpoints

Introduction

Core concepts

Features

Compliance

Payments

References

KYB

Components of a KYB Application

Business

Associated Parties

Information Required

Profile

Documentation

Associated Parties

Questionnaire

Example: Full KYB Flow

Business Documents

Government Issued ID

Proof of Address

Expected Behavior

RFI Actions

Getting Help

​Components of a KYB Application

Business

Associated Parties

​Information Required

​Profile

​Documentation

​Associated Parties

​Questionnaire

​Example: Full KYB Flow

​Business Documents

​Government Issued ID

​Proof of Address

​Expected Behavior

​RFI Actions

​Getting Help

​Related Resources

Components of a KYB Application

Information Required

Profile

Documentation

Associated Parties

Questionnaire

Example: Full KYB Flow

Business Documents

Government Issued ID

Proof of Address

Expected Behavior

RFI Actions

Getting Help

Related Resources