POST
/
api
/
v1
/
loans
/
book-loan
Book a new loan for a customer.
curl --request POST \
  --url https://demoapi.saasphereltd.com/api/v1/loans/book-loan \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customer_id": "CUST001",
  "internal_account_number": "1234567890",
  "product_id": 1,
  "loan_amount": 500000,
  "tenor": 12,
  "type": "new",
  "repayment_mode": "monthly",
  "first_repayment_date": "2025-12-26",
  "account_officer": 5,
  "account_number": "9876543210",
  "bank": "044",
  "account_name": "ABC Limited",
  "monthly_obligation": 50000,
  "mgt_fee": 5000,
  "rrr": "123456789012",
  "paystack_mandate_id": "MND_abc123"
}
'
{
  "status": "00",
  "message": "Loan booked 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"

​
internal_account_number
string
required

The internal account number for loan settlement.

Example:

"1234567890"

​
product_id
integer
required

The loan product ID.

Example:

1

​
loan_amount
number
required

The loan amount requested.

Example:

500000

​
tenor
integer
required

The loan tenor in months.

Example:

12

​
type
string
required

The application type (e.g., new, renewal).

Example:

"new"

​
repayment_mode
string
required

The repayment mode.

Example:

"monthly"

​
first_repayment_date
date
required

The first repayment date.

Example:

"2025-12-26"

​
account_officer
integer

optional The account officer ID.

Example:

5

​
account_number
string

optional The disbursement account number (required for corporate customers).

Example:

"9876543210"

​
bank
string

optional The disbursement bank code (required for corporate customers).

Example:

"044"

​
account_name
string

optional The disbursement account name (required for corporate customers).

Example:

"ABC Limited"

​
monthly_obligation
number

optional Other monthly obligations.

Example:

50000

​
mgt_fee
number

optional Management fee.

Example:

5000

​
rrr
string

optional Remita Retrieval Reference.

Example:

"123456789012"

​
paystack_mandate_id
string

optional Paystack mandate ID for direct debit.

Example:

"MND_abc123"

Response

200 - application/json
​
status
string
Example:

"00"

​
message
string
Example:

"Loan booked successfully"

​
data
object