HIFI Docs

Information Required

Different information is required for verification, including both non-documentary and documentary checks. Each associated party requires their own profile and identity documentation.

Profile

Field	Description	Required
`firstName`	Legal first name	Yes
`lastName`	Legal last name	Yes
`dateOfBirth`	Date of birth (YYYY-MM-DD)	Yes
`email`	Contact email address	Yes
`phoneNumber`	Phone number with country code	Yes
`physicalAddress`	Residential address (line1, city, state, postalCode, country)	Yes
`taxId`	Tax identification number in the party’s country	Yes
`taxIdType`	Tax identification number type (e.g. SSN, ITIN)	No
`taxIdCountry`	Tax identification number issuance country	No
`nationality`	Nationality of the associated party	Yes
`shareProportion`	Percentage of the business owned by this party	Yes
`relationshipEstablishedAt`	Date the party’s relationship with the business was established (YYYY-MM-DD)	Yes

Documentation

For more details check Documents

Document Group	Accepted Type	Required
`identity`	`DRIVERS`, `ID_CARD`, `PASSPORT`, `RESIDENCE_PERMIT`	Yes
`proofOfResidence`	`UTILITY_BILL`, `BANK_STATEMENT`, `RENTAL_AGREEMENT`, `TAX_DOCUMENT`, `VOTER_REGISTRATION_CARD`, `BANK_REFERENCE_LETTER`, `LEASE_OR_TENANCY_AGREEMENT`, `PROOF_OF_ADDRESS`	Yes*

For US and Canadian associated parties, proof of address is optional if a driver’s license, national ID, or resident permit is submitted as the government-issued ID.

Example: Add an Associated Party

Add the associated party

Add the party’s non-documentary information to the business userRequest

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 '{
    "firstName": "Henry",
    "lastName": "Wu",
    "dateOfBirth": "1998-03-29",
    "email": "henry@hifi.com",
    "phoneNumber": "+18572719480",
    "physicalAddress": {
        "addressLine1": "Example St 1.",
        "city": "Hoboken",
        "stateProvinceRegion": "NJ",
        "postalCode": "07030",
        "country": "USA"
    },
    "taxId": "23423123",
    "nationality": "USA",
    "shareProportion": 30,
    "relationshipEstablishedAt": "2022-03-22"
  }'

Response

{
    "id": "ap_kF9sLm2QwXcVbN3yTzR8p",
    "userId": "usr_8kL2MdPcfxmB6OyzXWQNr",
    "firstName": "Henry",
    "middleName": null,
    "lastName": "Wu",
    "nationality": "USA",
    "email": "henry@hifi.com",
    "phoneNumber": "*******9480",
    "physicalAddress": {
        "addressLine1": "Example St 1.",
        "addressLine2": null,
        "city": "Hoboken",
        "stateProvinceRegion": "NJ",
        "postalCode": "07030",
        "country": "USA"
    },
    "dateOfBirth": "1998-03-29",
    "taxId": "****3123",
    "taxIdType": null,
    "taxIdCountry": null,
    "shareProportion": 30,
    "relationshipEstablishedAt": "2022-03-22",
    "createdAt": "2026-07-14T18:03:12.114Z",
    "updatedAt": "2026-07-14T18:03:12.114Z"
}

Add Documentation

Upload the documentation to fulfill the party’s identity and proof of address requirements, using the associatedPartyId returned in the previous step

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_kF9sLm2QwXcVbN3yTzR8p/documents" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "PASSPORT",
    "subType": "SINGLE_SIDE",
    "issuedCountry": "USA",
    "issuedDate": "2024-05-04", // optional
    "expiryDate": "2030-05-04", // optional
    "fileId": "file_O8A1X7gCKoYxlb2aMYYzK"
  }'

Response

{
    "id": "doc_lPeFxGI2dAVFvLV2g7b33",
    "userId": "usr_8kL2MdPcfxmB6OyzXWQNr",
    "associatedPartyId": "ap_kF9sLm2QwXcVbN3yTzR8p",
    "type": "PASSPORT",
    "subType": "SINGLE_SIDE",
    "issuedCountry": "USA",
    "issuedDate": "2024-05-04",
    "expiryDate": "2030-05-04",
    "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_kF9sLm2QwXcVbN3yTzR8p/documents" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "UTILITY_BILL",
    "subType": "SINGLE_SIDE",
    "issuedCountry": "USA",
    "issuedDate": "2024-05-04", // optional
    "expiryDate": "2030-05-04", // optional
    "fileId": "file_ofidSSDFHS7538ffbje9"
  }'

Response

{
    "id": "doc_lPeFxGI2dAVFvLV2g7b33",
    "userId": "usr_8kL2MdPcfxmB6OyzXWQNr",
    "associatedPartyId": "ap_kF9sLm2QwXcVbN3yTzR8p",
    "type": "UTILITY_BILL",
    "subType": "SINGLE_SIDE",
    "issuedCountry": "USA",
    "issuedDate": "2024-05-04",
    "expiryDate": "2030-05-04",
    "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.

Associated parties are verified as part of the business’s KYB application — they do not have a separate compliance status. Once all parties are added, submit the business’s application and track its status as described in KYB (Business). If an associated party’s information needs updating, the business’s application will move to REQUIRES_INFO with an UPDATE_ASSOCIATED_PARTY action in the rfiActions field, including the associatedPartyId and the fields to correct. 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": "UPLOAD_DOCUMENT",
            "associatedPartyId": "apt_kF9sLm2QwXcVbN3yTzR8p",
            "message": "Please upload a complete shareholder register including all pages.",
            "documentId": "doc_puDSeif893FEyblK"
        }
    ]
}

Optional Liveness Check

A liveness check may be required for associated parties of a business user from a high-risk jurisdiction. When required, a verification link will appear under rfiActions with type COMPLETE_LIVENESS_CHECK and all associated parties must complete the liveness check before the KYB process can continue. 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"
        }
    ]
}

Getting Help

📧 Email: support@hifi.com
💬 Slack: Message us in our shared Slack channel

KYB (Business) - Business verification requirements
KYC (Individual) - Individual verification requirements
Documents - Document types and upload details

Introduction

Core concepts

Features

Compliance

Payments

References

Associated Party

Information Required

Profile

Documentation

Example: Add an Associated Party

Government Issued ID

Proof of Address

Optional Liveness Check

Getting Help

​Information Required

​Profile

​Documentation

​Example: Add an Associated Party

​Government Issued ID

​Proof of Address

​Optional Liveness Check

​Getting Help

​Related Resources

Information Required

Profile

Documentation

Example: Add an Associated Party

Government Issued ID

Proof of Address

Optional Liveness Check

Getting Help

Related Resources