Skip to main content
This guide builds on the concept of entities.
In addition to sending Nuvion information on the person or business that you onboard, you may be required to upload KYB/KYC documents as evidence. To upload a document, send a POST request to the /documents endpoint with the file URL and the individual’s or business’ information.
You’ll need to retrieve the person_id returned after creating an entity.
curl --location 'https://api.nuvion.dev/documents' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{$NUVION_API_KEY}}' \
--data-raw '{
    "description": "Business registration certificate",
    "urls": {
        "main": "https://storage.example.com/documents/reg-cert-123.pdf"
    },
    "meta": {
        "file_size": 2048576,
        "file_type": "application/pdf",
        "document_category": "business_registration",
        "verification_notes": "Original certificate issued by state authorities",
        "expiry_date": "2030-12-31"
    },
    "link_to_identity": {
        "person_id": "01HJ5G6R7MXW5ZK2QD6YA8N9F5",
        "identity_type": "international_passport",
        "auto_update_verification": true
    }
}'

​
Required documents

The following compliance documents are needed for onboarding.
Entity typeDocumentFormat
BusinessCertificate of incorporation.pdf
BusinessMemorandum of Understanding.pdf, .docx
BusinessProof of Address.pdf, .jpg, .png
BusinessValid ID document (per UBO or Director).pdf, .jpg, .png
BusinessProof of Address (per UBO or Director).pdf, .jpg, .png
IndividualDocumentFormat