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"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.business.blaaiz.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

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

Body

application/json

This endpoint allows you to request a pre-signed URL to upload a file for a customer. You will specify the file type you want to upload and for whom.

File Category identity - Identity document. Required to verify a customer. IMPORTANT: Only a Driver's License, Passport, or Resident Permit is accepted for individual customers. Only a Certificate of Incorporation is accepted for business customers. ID cards (National Identity Cards) are NOT accepted. No other document types are supported. identity_back - Back side of the identity document. Use this when the identity document is two-sided (e.g. driver's license). Not required for single-sided documents (e.g. passport, certificate of incorporation). proof_of_address - Proof of address. liveness_check - Liveness check.

Document quality: 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