Skip to main content
POST
/
api
/
external
/
file
/
get-presigned-url
Request file upload URL
curl --request POST \
  --url https://api-prod.blaaiz.com/api/external/file/get-presigned-url \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customer_id": "customer_123",
  "file_category": "identity"
}
'
{
  "message": "Upload URL generated successfully",
  "file_id": "file_123456789",
  "url": "https://s3.amazonaws.com/bucket/path?signature=xyz",
  "headers": {
    "Content-Type": "image/jpeg"
  }
}

Authorizations

​
Authorization
string
header
required

Use your OAuth client credentials to obtain a short-lived Bearer token from POST /oauth/token.

Body

application/json

Individual customers only. This endpoint provides a presigned URL for uploading legacy 4-slot KYC files (identity, identity_back, proof_of_address, liveness_check) for an individual customer.

Do not use this endpoint for type=business customers. Business-type customers use dedicated upload endpoints — POST /api/external/customer/{customer}/owner/{owner}/file/presigned-url for owner ID files and POST /api/external/customer/{customer}/document/presigned-url for KYB documents. See the Business customer KYB guide.

File Category:

  • identity — Identity document. Required to verify an individual customer. Only a Driver's License, Passport, or Resident Permit is accepted. ID cards (National Identity Cards) are NOT accepted.
  • identity_back — Back side of the identity document. Use this when the identity document is two-sided (e.g. driver's license).
  • proof_of_address — Proof of address.
  • liveness_check — Liveness check.

All uploaded documents must be clear, legible, and authentic. Blurry, cropped, obscured, or unclear images will not be reviewed and will be rejected. Fraudulent or falsified documents will not be tolerated — repeated attempts will result in the customer being permanently blacklisted from the platform.

​
customer_id
string
required

Unique identifier of the customer

​
file_category
enum<string>
required

Category of the file. For the identity category: only a Driver's License, Passport, or Resident Permit is accepted for individual customers, and only a Certificate of Incorporation for business customers. ID cards (National Identity Cards) are NOT accepted. All documents must be clear and legible — unclear images will be rejected. Fraudulent documents will result in permanent blacklisting.

Available options:
identity,
identity_back,
proof_of_address,
liveness_check

Response

Upload URL generated successfully

​
message
string
required
​
file_id
string
required

Unique identifier for the file

​
url
string<uri>
required

Pre-signed URL to upload the file

​
headers
object
required

Headers to include when uploading the file