Request Sender Document Upload URL

Use this endpoint to get a secure, temporary link to upload the sender's identity document (for example, a passport). You then attach the uploaded document to a transaction with sender_identifier_document_id in Create transaction.

How it works

Request an upload URL: call this endpoint with the file name, content type and size. Keep the document_id from the response.

Upload the file: send the file bytes in an HTTP PUT request to upload_url.

Set the Content-Type header to the exact content_type value from the response.

Do not add a Balad Authorization header. The URL is already signed.

Upload before expires_in_seconds ends. After that, request a new URL.

Create the transaction: send document_id as sender_identifier_document_id in Create transaction.

File rules

Rule	Value
Allowed extensions	`.jpg`, `.jpeg`, `.png`, `.pdf`
Maximum size	5 MB (5,242,880 bytes)
Usage	One document can be attached to one transaction only

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Example

{
    "file_name": "passport.pdf",
    "content_type": "application/pdf",
    "size_in_bytes": 482133
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Bodyapplication/json