BVbvnk
Onboarding

Upload company documents

Changed on

Uploads company-level KYB documents for an onboarding application as multipart/form-data.

The metadata field is a JSON array and files contains one file per metadata entry in matching order.

Use this endpoint for initial mandatory KYB files and for conditional/risk-triggered requests (for example Source of Wealth, AML policy, or regulatory licence). If a document is rejected later, re-upload the corrected file to this endpoint to replace the rejected submission.

Best practice: upload documents sequentially and add a 1-second delay to reduce rate-limit pressure.

post/onboarding/v1/applications/{onboardingId}/documents

Request

Path parameters

onboardingIdstring uuid required
Example:810fd34b-54d3-4a95-9d87-28804c3353b9

Onboarding application ID.

Request body multipart/form-data

metadatastring required

JSON array (string) of company document metadata entries with type, filename, and optional description.

Supported company document types:

TypeDescriptionWhen required
CERTIFICATE_OF_INCORPORATIONCertificate of incorporation or business formation document.Mandatory (US + EU BVNK-Managed, US Partner-managed)
MEMORANDUMMemorandum of Association.Mandatory (BVNK-Managed)
ARTICLE_OF_ASSOCIATIONArticles of Association.Mandatory (BVNK-Managed)
PROOF_OF_DIRECTORSHIPRegistry extract or certified register of directors.Mandatory (BVNK-Managed)
CORPORATE_STRUCTUREOwnership chart showing all shareholders through to UBOs.Mandatory (BVNK-Managed)
PROOF_OF_OPERATIONAL_ADDRESSUtility bill, lease, or official correspondence. Dated within 3 months.Required if operational address differs from registered
SOURCE_OF_FUNDSBank statements (3 months activity) or equivalent.May be requested during compliance review (RFI)
SOURCE_OF_WEALTHAudited accounts, financial statements, loan agreements.Conditional: triggered by high-risk rating or EDD
PROOF_OF_REGULATORY_LICENSECurrent regulatory licence for the declared jurisdiction.Conditional: required for regulated entities
AML_POLICYAML policy signed by Director/MLRO.Conditional: required for regulated entities
SHAREHOLDER_OWNERSHIPOwnership documentation for complex structures.Conditional: trusts, nominees, >3 layers, offshore
filesstring[] required

One file per metadata entry, in matching order.

Example request

{
  "metadata": "[{\"type\":\"CERTIFICATE_OF_INCORPORATION\",\"filename\":\"certificate.png\",\"description\":\"Certificate of Incorporation\"},{\"type\":\"MEMORANDUM\",\"filename\":\"memorandum.png\",\"description\":\"Memorandum of Association\"},{\"type\":\"ARTICLE_OF_ASSOCIATION\",\"filename\":\"articles.png\",\"description\":\"Articles of Association\"},{\"type\":\"PROOF_OF_DIRECTORSHIP\",\"filename\":\"directorship.png\",\"description\":\"Proof of Directorship\"},{\"type\":\"CORPORATE_STRUCTURE\",\"filename\":\"corporate_structure.png\",\"description\":\"Corporate Structure Chart\"},{\"type\":\"PROOF_OF_OPERATIONAL_ADDRESS\",\"filename\":\"address_proof.png\",\"description\":\"Proof of Operational Address\"}]"
}

Response

Documents accepted for processing

onboardingApplicationIdstring uuid required
documentCountinteger required
messagestring required

Changes