Upload File

POST

/api/v1/utilities/uploadfile

Uploads one or more documents (images, PDFs) — for example KYC/KYB identity documents. Files are stored in Azure Blob Storage and the returned URLs can be used in customer onboarding fields such as frontDocument or photo.

⚠️ Required Fields

Field	Type	Description	Constraints
`files`	`file[]`	One or more files to upload, as `multipart/form-data`	Accepted: `image/jpeg`, `image/png`, `application/pdf`

Optional Fields

Field	Type	Description	Constraints
`X-Idempotency-Key` (header)	`string`	Client-generated key that makes a retried upload safe to replay — reusing a key returns the original result instead of creating a duplicate	Nullable

📤 Response Fields

Field	Type	Description
`data[].fileName`	`string`	Original file name
`data[].url`	`string`	Blob storage URL of the uploaded file

Request

Header Params

Body Params multipart/form-dataRequired

Responses

🟢200

application/json

Files uploaded successfully.

Bodyapplication/json

🟠401

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v1/utilities/uploadfile' \
--header 'X-API-Key;' \
--header 'X-Signature;' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Body-Hash;' \
--header 'X-Idempotency-Key: 6f1a9c0e-2b7d-4c31-9f8a-1d5e7c3b0a42' \
--form 'files="passport_front.jpg"' \
--form 'files="passport_back.jpg"'

Response Example

200 - Success

{
    "data": [
        {
            "fileName": "passport_front.jpg",
            "url": "https://storage.blob.core.windows.net/docs/passport_front.jpg"
        },
        {
            "fileName": "passport_back.jpg",
            "url": "https://storage.blob.core.windows.net/docs/passport_back.jpg"
        }
    ]
}

Modified at 2026-08-31 12:46:35

List Product Industry Codes

Wallets Webhooks