Request pre-signed URLs for beneficiary (associate) document uploads

Testing Env

https://api.uat.sokin.com

POST

/corporates/beneficiaries/documents

Request pre-signed upload URLs for identity and address verification documents required for a beneficiary during onboarding.

These documents must be uploaded externally using the URLs returned in the API response.
Document checks are part of Sokin's compliance process and are completed before the application proceeds.

After submitting your request, the system will generate pre-signed URLs based on the id_type and address_type you provide. For example, if id_type = Passport, only the front image is required. The response will include a pre-signed URL for id_image_front only.

Each pre-signed URL:

Remains valid for 10 minutes

Allows one file upload (reusing it will overwrite the previous file)

Accepts files up to 20 MB in size

Accepted file formats include:

PDFs (application/pdf, pdf)

Images (image)

All files must be linked to a valid associate_id.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Pre-signed URL for document upload.

Body

🟠400

🟠401

🟠403

🟠404

🟠422

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.uat.sokin.com/corporates/beneficiaries/documents' \
--header 'x-api-version;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "associateId": "string",
    "idType": "string",
    "idContentType": "string",
    "idNumber": "string",
    "issuedCountry": "string",
    "idExpiryDate": "string",
    "addressType": "string",
    "addressContentType": "string",
    "documentName": "string"
}'

Response Example

201 - Example 1

{
    "message": "string",
    "data": {
        "status": "string",
        "success": true,
        "message": "string",
        "presignedResponse": {
            "url": "string",
            "fields": {}
        }
    }
}

Modified at 2026-01-09 10:02:56

Request pre-signed URLs for Corporate onboarding document uploads

Finalise corporate onboarding submission