Upload a file

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.

The following combinations are permitted:

  • verification_report (application/pdf, application/json)
  • idcard_both_sides (image/bmp, image/x-ms-bmp, image/x-bmp, image/jpeg, image/png, image/heic, image/heif, application/pdf)
  • idcard_front (image/bmp, image/x-ms-bmp, image/x-bmp, image/jpeg, image/png, image/heic, image/heif, application/pdf)
  • idcard_back (image/bmp, image/x-ms-bmp, image/x-bmp, image/jpeg, image/png, image/heic, image/heif, application/pdf)
  • paper_id (image/bmp, image/x-ms-bmp, image/x-bmp, image/jpeg, image/png, image/heic, image/heif, application/pdf)
  • passport (image/bmp, image/x-ms-bmp, image/x-bmp, image/jpeg, image/png, image/heic, image/heif, application/pdf)
  • driving_licence (image/bmp, image/x-ms-bmp, image/x-bmp, image/jpeg, image/png, image/heic, image/heif, application/pdf)
  • residence_permit (image/bmp, image/x-ms-bmp, image/x-bmp, image/jpeg, image/png, image/heic, image/heif, application/pdf)
  • selfie_video (video/*)
  • other (application/pdf , image/bmp, image/x-ms-bmp, image/x-bmp, image/jpeg, image/png, image/heic, image/heif* , video/*)
SecuritybearerAuth
Request
Request Body schema: multipart/form-data

The file to be uploaded.

purpose
string

The purpose of the file

Enum: "driving_licence" "idcard_back" "idcard_both_sides" "idcard_front" "other" "paper_id" "passport" "residence_permit" "selfie_video" "verification_report"
file
string <binary>

The file content

Responses
201

New file has been uploaded

401

Error

422

Error

429

Too Many Requests

500

Error

503

Maintenance or Service unavailable

post/v1/files
Request samples
Response samples
application/json
{
  • "data": [
    ]
}