Onboard Businesses
Provide Onboarding Information
Several pieces of information are necessary to successfully onboard a business and move its account status from PENDING to OPEN. After submission, this information will be reviewed. Once the information has been approved, the account’s status will be changed to OPEN.
To get started, initiate a request to the POST /v1/businesses/{business_id}/onboarding endpoint with all KYC/KYB information.
For security purposes, it is highly recommended to use fake data in the sandbox environment.
The same onboarding endpoint is used for agreeing to required documents, including an investment management agreement, entity LLC agreement, and new account agreement. Treasure will provide these documents to be shown to users for explicit agreement in the request:
{
"policies": {
"investment_management_agreement": true,
"entity_llc_agreement": true,
"entity_new_account_ria": true
}
}
When submitting this request, you are legally agreeing that end users have seen and accepted the aforementioned agreements.
KYC will be triggered once all the required onboarding information has been submitted. The pending account will have a new sub_status of INTERNAL_REVIEW, and the Treasure KYB team will contact you for further information if necessary. Once the review is finished, the status will be changed to approved or denied.
Upload a Formation Document
The custodian requires a formation document, such as articles of incorporation or an operating agreement, before an account can be opened. This should be sent separately from the onboarding submission via the POST /v1/businesses/{business_id}/onboarding/formation_document endpoint as multipart form data. The file belongs in a field named file.
A successful upload returns { "uploaded": true }. The response of GET /v1/businesses/{business_id}/onboarding should then also report formation_document.uploaded: true. This field is read-only and is ignored if you send it in the onboarding submission.
Submitting onboarding info itself (via this endpoint) still moves the account to INTERNAL_REVIEW, even without a formation document uploaded. This behavior is solely for backwards compatibility reasons, and will be disabled soon. At that time, uploading a formation document will be required in addition to the upload of standard onboarding information for the business to move to INTERNAL_REVIEW.
Get Onboarding Information
At any time, onboarding information for a specific business can be fetched via a request to request to the GET /v1/businesses/{business_id}/onboarding endpoint.
