New loan application

Apply for loans from any of the setup business branches and get funds disbursed directly into provided bank details.

Create a new loan application

POST https://<your_business_alias>.lenda.ng/ias/loan

This endpoint creates a new loan application on the system. To automate Loan approval at creation, set it up by calling this endpoint /loan/autosetting/activate/deactivate

Headers

Name	Type	Description
Authentication*	string	The encoded combination of your public key and secret key (see the Test and go live section of the docs)

Request Body

Name	Type	Description
BranchId	integer	Id of the branch where loan is created (you can spool list of branches from /ias/branch/branches)
UtilityBillFile	string	Utility bill document (Max 5MB) Formats Allowed: ".png", ".jpeg", ".jpg", ".docx", ".pdf"
BankStatementFile	object	Customer's bank statement filte. (Max 5MB) Formats Allowed: ".png", ".jpeg", ".jpg", ".docx", ".pdf"
DateOfBirth	string	Customer's date of birth
NextOfKinAddress	string	Customer's next of kin address
NextOfKinPhoneNumber	string	Customer's next of kin phone number
NextOfKinName	string	Customer's next of kin name
CustomerAltPhoneNumber	string	Customer's next of kin alternative phone number
CustomerPhoneNumber	string	Customer's phone number
SalesPersonId	string	Id of salesperson
Gender	string	Customer's gender
RepaymentMethod *	string	Method for loan repayment. Must be: Cash Card - Paystack Cheque Deduction At Sourceor Automatic Direct Debit - Remita
UtilityBill	object
ResidentialAddress *	string	Customer's residential address
BankAccountName	string	Customer's bank account name
BankAccountNumber *	string	Customer's bank account number
BankName *	string	Customer's bank name
BankSortCode *	string	Customer's bank sort code
EmployerId	integer	Id of customer's employer if employed (you can spool list of employers from ias/employer/employers)
EmployerName	string	Customer's employer name. Required if the customer's employer is not on the system
EmployerPhone	string	Customer's employer phone number. Required if the customer's employer is not on the system
EmployerEmailAddress	string	Customer's employer email. Required if the customer's employer is not on the system
EmployerAddress	string	Customer's employer address. Required if the customer's employer is not on the system
EmployerPayDate	integer	Customer's employer pay date. Required if the customer's employer is not on the system
EmploymentCode	string	Customer's employment code. Required if the customer's employment status is Employed
GradeLevel	string	Customer's grade level. Required if the customer's employment status is Employed
DateOfEmployment	string	Customer's employment date. Required if the customer is employed
BankStatement	object	Customer's bank statement file
EmploymentIndustryId	integer	Id of customer's employment industry (you can spool list of employment industry from /ias/employer/employers)
EmploymentStatus *	string	Employment status must be EMPLOYED or SELF EMPLOYED
Bvn	string	Customer's bank verification number
CustomerId*	integer	Customer's Id (you can spool list of customers from /ias/loan/persons)
EmailAddress	string	Customer's email address (must be a valid email adress)
NetIncome*	number	Customer's net income
LoanReasonId	integer	Loan reason id (you can spool list of loan reasons from /ias/loan/loanreasons/:searchParameter)
LoanDuration *	integer	Duration of the loan in months or weeks depending on the loan type specified (must be a number greater than zero)
LoanAmount *	number	The loan amount (Allowed range will vary according to the loan product selected )
LoanTypeId *	number	Id of the loan product (you can spool list of loan types from /ias/loan/loantypes/:branchId)

200 Cake successfully retrieved.

{
    "data": 20, //loanId
    "status": true,
    "message": "Success"
}