Upload a financial file

POST

/v1/files/financial-document

Use this endpoint to upload financial documents of a user, requested by Bitpanda as proof of funds or proof of wealth.
Each document is attached to the case provided by Bitpanda (appian_case_id). When a case requires multiple documents, upload them one per request, using document_number to indicate the position of the document (starting at 1) and documents_count to indicate the total number of documents for the case.

Unlike Upload a file, no file id is returned, as financial documents are not referenced in other endpoints.

The following purposes are permitted:

proof_of_funds - evidence of the origin of the funds used by the user

proof_of_wealth - evidence of how the user's overall wealth has been accumulated

The document name must be maximum 125 characters long. The file should have a maximum of 20 megabytes.

The following MIME types are permitted for both purposes: application/pdf, image/jpeg, image/png.

Request

Authorization

Header Params

Body Params multipart/form-dataRequired

Responses

🟢201Created

application/json

New financial document has been uploaded

Bodyapplication/json

🟠401Unauthorized

🟠422Parameter Error

🟠429

🔴500Server Error

🔴503Service Unavailable

Request Example

Shell

JavaScript

Java

curl --location 'https://test.whitelabel.bitpanda.com/v1/files/financial-document' \
--header 'bp-user-id: a1b2c3d4-e5f6-7890-abcd-ef1234567890' \
--form 'purpose="proof_of_funds"' \
--form 'appian_case_id="12345"' \
--form 'appian_document_name="bank_statement.pdf"' \
--form 'document_number="1"' \
--form 'documents_count="3"' \
--form 'document=@"@/path/to/bank_statement.pdf"'

Response Example

201 - Example 1

{
    "data": {
        "name": "bank_statement.pdf",
        "type": "application/pdf",
        "size": 102400,
        "purpose": "proof_of_funds",
        "created_at": "2026-10-12T08:14:20+00:00"
    }
}

Modified at 2026-10-21 09:44:02

Get file information

Get Terms & Conditions