Create withdrawal request

Submits a new withdrawal request for a unit the investor holds an active investment in.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/jsonRequired

Example

{
    "unit_id": 5,
    "reason": "I want to exit this investment."
}

Responses

🟢201

application/json

Withdrawal request created

Body

Example

{
    "success": true,
    "message": "Withdrawal request created successfully.",
    "data": {
        "id": 1,
        "unit_id": 5,
        "investor_id": 1,
        "ownership_percentage": 10,
        "invested_amount": 100000,
        "reason": "I want to exit this investment.",
        "status": "pending",
        "rejection_reason": null,
        "created_at": "2026-02-13T10:30:00+00:00",
        "updated_at": "2026-02-13T10:30:00+00:00"
    }
}

🟠400

🟠401

🟠422