POST
/
api
/
v1
/
investments
/
create
Create a new investment.
curl --request POST \
  --url https://demoapi.saasphereltd.com/api/v1/investments/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customer_id": "CUST001",
  "account_number": "1234567890",
  "amount": 1000000,
  "interest_rate": 12.5,
  "start_date": "2025-11-26",
  "tenor": 90,
  "payment_mode": "maturity",
  "interest_mode": "annually",
  "account_officer_id": 5
}
'
{
  "status": "00",
  "message": "Investment created and approved successfully",
  "data": {}
}

Authorizations

​
Authorization
string
header
required

Paste only the token (no "Bearer " prefix).

Body

application/json
​
customer_id
string
required

The customer ID.

Example:

"CUST001"

​
account_number
string
required

The account number for the investment.

Example:

"1234567890"

​
amount
number
required

The investment amount.

Example:

1000000

​
interest_rate
number
required

The interest rate (percentage).

Example:

12.5

​
start_date
date
required

The investment start date (cannot be in the future).

Example:

"2025-11-26"

​
tenor
integer
required

The investment tenor in days.

Example:

90

​
payment_mode
string

optional The payment mode (maturity or periodic). Defaults to maturity.

Example:

"maturity"

​
interest_mode
string

optional The interest mode (annually, quarterly, etc). Defaults to annually.

Example:

"annually"

​
account_officer_id
integer

optional The account officer ID.

Example:

5

Response

200 - application/json
​
status
string
Example:

"00"

​
message
string
Example:

"Investment created and approved successfully"

​
data
object