Skip to main content
POST
/
partner
/
files
Upload file
curl --request POST \
  --url https://api.contro.me/v1/partner/files \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-contro-api-key: <api-key>' \
  --form purpose=kyc_id_front \
  --form 'file=<unknown>'
{
  "id": "file_abc123",
  "fileName": "passport_front.jpg",
  "size": 204800,
  "purpose": "kyc_id_front",
  "createdAt": "2026-03-20T14:30:00Z"
}

Authorizations

​
x-contro-api-key
string
header
required

Partner API key (sk_live_* for production, sk_test_* for sandbox)

Body

multipart/form-data
​
purpose
enum<string>
required

Purpose of the file upload (e.g. kyc_id_front, kyc_face_photo)

Available options:
kyc_id_front,
kyc_face_photo,
kyc_address_proof,
kyc_asset_proof
​
file
any

File to upload

Response

File uploaded

​
id
string
required

File ID

Example:

"file_abc123"

​
fileName
string
required

Original file name

Example:

"passport_front.jpg"

​
size
number
required

File size in bytes

Example:

204800

​
purpose
enum<string>
required

File purpose

Available options:
kyc_id_front,
kyc_face_photo,
kyc_address_proof,
kyc_asset_proof
​
createdAt
string
required

ISO 8601 creation timestamp

Example:

"2026-03-20T14:30:00Z"