Use this endpoint to upload user related files. When a file is uploaded, an id will be returned, which shall be used as a reference to a file in other user related endpoints, e.g. when creating or updating user or sending additional verification files. A validation, based on the file purpose and the MIME type is performed. The filename must be minimum 3 characters long and maximum 255 characters long. The filename cannot start with "." (dot). The file should have a minimum of 15 bytes, and a maximum of 50 megabytes.
proof_of_address
should be use to upload files used as evidence of the permanent residential address of a natural person, such as:
The following combinations are permitted:
application/pdf
, application/json
)image/bmp
, image/x-ms-bmp
, image/x-bmp
, image/jpeg
, image/png
, image/heic
, image/heif
, application/pdf
)image/bmp
, image/x-ms-bmp
, image/x-bmp
, image/jpeg
, image/png
, image/heic
, image/heif
, application/pdf
)image/bmp
, image/x-ms-bmp
, image/x-bmp
, image/jpeg
, image/png
, image/heic
, image/heif
, application/pdf
)image/bmp
, image/x-ms-bmp
, image/x-bmp
, image/jpeg
, image/png
, image/heic
, image/heif
, application/pdf
)image/bmp
, image/x-ms-bmp
, image/x-bmp
, image/jpeg
, image/png
, image/heic
, image/heif
, application/pdf
)image/bmp
, image/x-ms-bmp
, image/x-bmp
, image/jpeg
, image/png
, image/heic
, image/heif
, application/pdf
)image/bmp
, image/x-ms-bmp
, image/x-bmp
, image/jpeg
, image/png
, image/heic
, image/heif
, application/pdf
)video/*
)image/bmp
, image/x-ms-bmp
, image/x-bmp
, image/jpeg
, image/png
, image/heic
, image/heif
, application/pdf
)application/pdf
, image/bmp
, image/x-ms-bmp
, image/x-bmp
, image/jpeg
, image/png
, image/heic
, image/heif*
, video/*
)The file to be uploaded.
New file has been uploaded
Error
Error
Too Many Requests
Error
Maintenance or Service unavailable
curl -i -X POST \ https://test.whitelabel.bitpanda.com/v1/files \ -H 'Authorization: Bearer <YOUR_JWT_HERE>' \ -H 'Content-Type: multipart/form-data' \ -F purpose=passport \ -F file=@/path/to/file.pdf
{- "data": [
- {
- "id": "f31f3c22-e7ea-11ec-8fea-0242ac120002",
- "name": "user_verification.pdf",
- "type": "application/pdf",
- "size": 25,
- "purpose": "verification_report",
- "url": "/v1/files/f31f3c22-e7ea-11ec-8fea-0242ac120002/contents",
- "created_at": "2022-07-20T08:14:20+00:00"
}
]
}