Skip to main content

Loan Save / Loan Creation Version 1

POST Loan Save

This is the API for creating or saving loans. The Loan Save Api receives the loan once it has been generated at LOS and uses it to build the customer's loan portfolio for SynoFin LMS.

URL: {{base_url}}/loan-management/v1/loan/save

Run in Postman: GET Loan Collaterals

Request: 

Request Type: GET
Authorization: Bearer Token

Query Parameter:
Schema
Attributes
Type Description Default Value / Master Value Mandatory
loan_application




dpd
integer($int32) Dpd represents Due Past Days It should always be a round number No
email
string Email represents applicant mail id
No
address
string applicant address
No
currency
integer($int32) The system or type of money that a particular country uses
No
tenure
integer($int32)
minimum: 1
The tenure in your loan is the time period between the disbursal of your loan and the last EMI payment that you make.
Yes
foir
number($double) Fixed Obligation to Income Ratio

gender
string Applicant gender Fetched From Masters
industry
string Type of industry master values (lists)
customer


dob

If DOB IS NULL THEN DOI ELSE DOB
Yes
remarks



No
obligations



No
email
string

No
address
line1



No
line2



No
pincode



No
city



No
state



No
country



No
type



No
residence_type



No
documents
description
string

No
document_url
string S3 bucket url
No
is_verified
string Document Identification number
No
applicant_type
boolean whether document is verified
No
customer_name
string

No
other_document_name
string

No
document_type
string

Yes (If, Document is uploaded)
document_status
string

No
document_state
string

No
receiving_date
string($date-time)

No
document_file
string

No
document_format
string

No
loan_id
integer($int64)

No
document_stage
string

No
disbursal_stage
string

No
document_department
string

No
religion
string

No
caste
string

No
crif
string

No
industry
string
master values (lists) No
website
string

No
first_name
string

Yes
last_name
string

Yes
middle_name
string

No
gender_id
integer
IF ID_Title = '1' Then 'Male' IF ID_Title = '2' Then 'Female' Else 'Others' No
category_id
string its represent category like General, OBC, SC/ST of a customer
No
place_of_birth
string place of birth of the customer
No
marital_status_id
string marital status of the customer
Yes
country_code
string phone country code of the customer
No
contact_person_name
string name of the contact person of the customer
No
contact_person_mobile
string mobile no. of the contact person of the customer
No
contact_person_email
string email of the contact person of the customer
No
preferred_address
string

No
phone_number
type
string Type of Phone number
Yes
phone
string Phone Number
Yes
code
string Country code
No
extn
string Phone Extension
No
is_whatsapp_no
boolean whether it is whatsapp number or not
No
related_people age
integer($int32) Age of the person related to customer
No

dependants
integer($int32)

No
remarks
string

No
name
string Name
No
address
line1


No
type


No
dob
string($date-time)

No
degree_id
string

No
phone_number
type string Type of Phone number
Yes
phone string Phone Number
Yes
code string Country code
No
extn string Phone Extension
No
is_whatsapp_no boolean whether it is whatsapp number or not
No
occupation_id
string Occupation
No
same_occupation
boolean Whether same occupation as customer
No
living_with_him
boolean Is related people living with thw customer
No
medical_condition
string Medical condition
No
maiden_name
string the original surname of a married woman who uses her husband's surname name after marriage.
No
people_type
string

No
relation_id
string Relation With customer
No
education_qualification_id
string Education Qualification
No
customer_id



No
preferred_language



No
bank_details
branch_name
string name of bank branch
No
account_number
string Account Number
No
id
integer($int64)

No
bank_name
string Bank Name
No
is_repayment_account
boolean whether the bank account is repayment account
No
is_default_account
boolean

No
branch_ifsc
string Branch IFSC Code
No
bank_document
[...] Bank Related Dcouments
No
nach_detail
NachDetailRootRequestDTO{...}

No
umrn_no
string

No
customer_name
String Name of Customer
No
branch_code
Strinf Account Branch Code
No
account_type
string Type of Account
No
business_details
landmark
string landmark

phone
string


msme
boolean Ministry of Micro, Small & Medium Enterprises FALSE
ownership
string


state
string ownership of the business

district
integer($int64) code of the state

city
integer($int64) code of the district

earner
integer($int64) code of the city

company_or_firm_name
boolean check for identify the applicant is the earner or not

gross_monthly_income
string name of the company or firm of the customer

total_work_experience
integer($int64) gross monthly income of customer

major_occupation
integer($int32) total work of the customer in the business

full_address
boolean check whether the business is the major occupation of the customer or not

preferred_communication
string full address of the businees

pin_code
boolean preferred communication

total_expense
string pincode of the business address

udyog_aadhar
number($double) total expense of the business

loan_net_worth
string Udyog Aadhaar Memorandum (UAM) is a single-page registration form under which, as an MSME registration, you can self-certify your entity's existence, bank details, promoter/ owner's Aadhaar details and other needed details

designation
number($double) what is the net worth of the loan

monthly_purchase
number($double) amount of purchase in a month

monthly_sale
number($double) monthly sale of in the business

total_year_of_operation
integer($int32) year of operation in business

occupation_type
string type of occupation

institution_details
[...] it contains instituition details of the customer like employerName, institution_name,registration_number etc

customer_type
string It holds the info about the type like applicant, coapplicant, guarantor the customer belongs to

relationship_with_applicant
string applicant releation with the customer

customer_relationship_id
string it is the customer id from los

is_individual
boolean


constitution_type
string it holds the constitution type details like proprietorship,
partnership of a customer


authorized_signatory
string


bureau_score
string bureau score of a customer

registration_number
string


registration_type
string


sub_industry
string it contains the sub industry info of the customer

partnership_percentage
integer($int32)


msme_flag
boolean


msme_subtype
string


customer_category
string it holds the info about customer category line indivisual or non-indivisual

commercial_bureau_score
number($double) it contains the commercial bureau score

kyc_risk_categorization
string


nach_detail
NachDetailRootRequestDTO{...} it contails info about nach deails like umrn no, mandate id, status etc

payment
PaymentToRequestDTO{...} It contains the payment info like account number, bank name , ifsc etc

insurance_data
[...] it contains insurence info of the customer

equifax
integer($int32) it represents the equifax score of the customer

education_qualification
string it represents education qualification of the cutome

graduate
number($double) total expense of the customer

total_expense
string global id of the customer which is common in all bank and nbfc for a particular customer

global_customer_id
integer($int32) number of dependent of the customer

number_of_dependents
string A guardian may also be called a conservator when the role includes managing the finances of the child or adult.

guardian_name
integer($int32) from how many number of year customer live in the current city

living_since_current_city
integer($int32) number of month living at the current address

months_at_current_address
integer($int32) number of months living at the current city

months_at_current_city
integer($int32) number of years living at current address

repayment_contribution_amount
integer($int32) number of years living at current city

repayment_contribution_percentage
number($double) the amount of earnings remaining after all direct costs have been subtracted from revenue from the repayment amount

repayment_mode
number($double) the percentage amount of earnings remaining after all direct costs have been subtracted from revenue from the repayment amount

isSubvention
string it represents the repayment mode of the EMI FALSE
irr
number($double) The internal rate of return (IRR) is a metric used in financial analysis to estimate the profitability of potential investments. null
source_application_number
string Source application number generate in LOS null Yes
product_id
string Type of product null Yes
branch_id
string Bank branch id
master values (branch)
0
dealer_id
string Dealer Id
master values (dealer)
null
loan_application_id
integer($int64) System auto generated auto_increament
interest_rate
number($double) Interest Rate 0 Yes
installment_frequency
string Instalment Frequency means the period You have nominated to pay, this being monthly or yearly in advance. null
sanctioned_amount
number($double) The amount made available by the Lender for disbursal to the Borrower as Loan
Yes
disbursed_amount
number($double) The agreed-upon amount is actually paid into the borrower's account and is available for use
Yes
paid_amount
number($double) Paid amount

original_tenure
integer($int32) Original tenure value

current_tenure
integer($int32) Current tenure value

installment_computed_on
string Installment computed on

sanction_date
string($date-time) An official document issued by a lending organisation to customers stating that their loan is approved.
Yes
ltv_ratio
number($double) Determines the maximum amount of a secured loan based on the market value of the asset pledged as collateral

tax_identification_number
string A Taxpayer Identification Number is an identifying number used for tax purposes in the United States and in other countries under the Common Reporting Standard.

loan_amount
number($double) Loan amount describes the total that one is authorized to borrow

loan_tenure
integer($int32) The tenure in your loan is the time period between the disbursal of your loan and the last EMI payment that you make.

installments_paid
integer($int32) Instalment payments refer to a customer paying a bill in small portions throughout a fixed period of time. Instalment payments are a payment plan arranged between the buyer and the seller. null
loan_marking
[...]


installment_amount
number($double) An installment loan is an agreement in which a loan is repaid over time through periodic payments. null
principal_outstanding
number($double) Outstanding principal refers to the remaining amount of the original loan, plus any capitalized interest. 0
customer_name
string Applicant name

phone_no
string Applicant phone number

is_whatsapp_no
boolean Applicant whatsapp number is store FALSE
advance_installment_count
integer($int32) The thing being in case of advance emi, you downpay extra installment counts

advance_installment_amount
number($double) Advance installment amount

total_installments
integer($int32) Number of total installments null
is_priority_sector_lending_applicable
boolean Priority sector lending is lending to those sectors of the economy which may not otherwise receive timely and adequate credit. This role is assigned by the Reserve Bank of India to the banks for providing a specified portion of the bank lending to few specific sectors like agriculture and allied activities, micro- and small enterprises, education, housing for the poor, and other low-income groups and weaker sections. FALSE
principle_outstanding
number($double) Outstanding principal refers to the remaining amount of the original loan, plus any capitalized interest. 0
total_overdue
number($double) Loan overdue refers to the loan amount that a customer fails to repay on time.

emi_due
number($double) Emi got due 0
other_charges
number($double) Other charges 0
disbursed_by
string Loan disbursed by
Yes
source_application_identifier
string Unique identifier number
Yes
product
string Lending products are any of the wide variety of bilateral credit products that are offered by private or public banking firms and institutions. Product values store in master
scheme
string A loan granted to a beneficiary by the Finance Partner that is aimed at financing a set of several pre-determined Projects under the Facility. Scheme value store in master Yes
loan_type
string Type of Loan

loan_application_number
string Loan Application number to identify loan

balance_principal
number($double) The principal balance of your loan is the original amount you borrowed 0
interest_rate_monthly
number($double) Interest rate monthly 0
customer_relationship_id
string Applicant global id

customer_category
string Applicant category

no_of_disbursement
integer($int32) Number of disbursement

customer_id
integer($int64) Applicant Id

product_code
string Product code

scheme_code
string Scheme code

loan_application_type
string Loan application type

branch_code
string Branch code

cibil_score
integer($int32) CIBIL Score is a three-digit numeric summary of your credit history. The score is derived using the credit history found in the CIBIL Report

lending_rate
number($double) Lending rate is the bank rate that usually meets the short- and medium-term financing needs of the private sector. This rate is normally differentiated according to creditworthiness of borrowers and objectives of financing.

scheme_lending_rate
number($double)


branch_state
string Branch State

branch_city
string Branch City

emi_amount
number($double) Emi Amount

customer_number
string Applicant number

branch_zone
string Branch zone

utilized_limit
number($double) Utilized Limit

dsa_name
string Direct Selling Agent. DSA's job is to find potential customers for the bank or the NBFC they represent.

unrealized_limit_amount
number($double) Unrealised limit amount

applied_amount
number($double) Actual applied amount by applicant for loan

branch_manager
string Branch manager

sourcing_channel
string Sourcing channel

risk_category
string Risk category

sourcing_channel_type
string Sourcing channel type

pd_location
string Pending Revolving Loans means, at any time, the aggregate principal amount of all Revolving Loans requested in any Notice of Borrowing received by the Agent .

account_classification
string Account classification Data Fetched From Masters
drawing_power
number Drawing power is the limit upon which every borrower can withdraw the money within the cash credit limit.

lien_mark
string Lien marking is the right given to the lender over a security to recover the money in case the credit given to the borrower is not repaid as per the terms agreed to.

lien_amount
number($double) he amount of money that gets locked by the bank for a fixed period of time.

tos
number($double) It is a type of document stating details about what a service provider is responsible for as well as user obligations that must be adhered to for continuation of the service.

debit_freeze
string Frozen accounts do not permit any debit transactions. When an account is frozen, account holders cannot make any withdrawals, purchases, or transfers, but they may be able to continue to make deposits and transfer into it

total_freeze
string


pemi_count
integer($int32) It is field to count to mantain the pre-emi count

loan_net_worth
number($double) Net worth is the difference between the asset and the liability of an individual or a company

start_principle_recovery
boolean Start of the principle recovery or not

caf_number
string Customer appllication form TRUE
no_of_cheque_bounce
integer($int64) Number of cheque bounce

dealer_code
string It is a 14-digit numerical code provided by a bank with which your business has a current account.

advance_interest
number($double) interest relating to a particular period of a loan, calculated or paid at the beginning of the period

advance_emi
number($double) refers to the type of EMI payments where the first EMI payment is made in advance to the lender

advance_emi_payment_mode
string Mod of advance emi payment mode

advance_interest_payment_mode
string advance interest payment mode

total_moratorium_count
integer($int32) count of total moratorium

next_emi_amount
number($double) amount of the next emi

grace_period
integer($int32) Grace period is a feature provided by banks or insurance companies so that customers can delay payment for a certain period of time after the due date

delinquency
integer($int32) Delinquency means that you are behind on payments.

moratorium_period
integer($int32) A moratorium period is a duration when the borrower doesn't have to make the home loan EMI payments

advance_amount_recovery_type
string


total_nach_bounce_count
integer($int32) count of the nach boune

total_count_of_repayment
integer($int32) total count of repayment

whatsapp_no
string whatsapp number

aggregated_ltv
number($double) he ratio, in which the numerator is equal to the Aggregate Principal Balance and the denominator is equal to the Appraised Value of the Properties

overline_amount
number($double) A loan amount in excess of a financial institution's legal lending limit to any one borrower in which the institution has enlisted the services of another lender to participate in the loan.

total_number_of_bounce_count




moratorium_type




moratorium_months




installment_plan
string Hire-purchase Plan, in business, credit that is granted on condition of its repayment at regular intervals, or installments, over a specified period of time until paid in full

installment_mode
string mode of installment paid

disbursal_status
string status of disbursal

credit_manager_id
integer($int32) id of credit manager

sourcing_rm
integer($int32) sourcing rm

loan_status
string status of loan

sourcing_rm_name
string name of sourcing rm

sourcing_supervisor
string


subvention_details
SubventionDetails{...}


loan_documents description





document_url




document_value




is_verified




applicant_type




customer_name




other_document_name




document_type




document_status




document_state




receiving_date




document_file




document_format




loan_id




document_stage




disbursal_stage




document_department




collateral description





address




pincode




remarks




identifier




longitude




latitude




capacity




status




marking




country




region




state




city




district




taluka




village




collateral_id




cersai_score




loan_id




is_building_constructed




built_up_area




carpet_area




age_of_property




residual_age_of_property




plot_number




seller_name




present_registered_owner




tct_no




lot_no




percentage_share




is_property_registered_in_favour_of_borrower




registration_number




agreement_value




amenities_agreement_value




owner_name




ownership_percentage_share




policy_note_number




insurance_company_name




insurance_term




coverage_amount




premium_amount




insurance_deviation_details




cersai_txn_ref_no




cersai_security_interest_id




cersai_no_of_borrowers




cersai_no_of_documents




cersai_no_of_third_parties




country_string




region_string




state_string




city_string




district_string




taluka_string




village_string




karat_value




gross_weight




net_weight




rf_id




collateral_product




installer_name




installer_gstno




installer_address




installer_city




installer_state




installer_pincode




installer_district




installer_id




cost_of_asset




pv_module_model




pv_module_make




inverter_model




inverter_make




asset_type




vehicle_type




manufacturer




product




model




chasis_no




dealer_name




dealer_address




dealer_city




dealer_state




dealer_pincode




policy_cover_note_number




insurance_company




start_date_disburse_date




coverage_type




ownership_status




installer_address_json




vehicle_registration_no




engine_no




global_collateral_identifier




property_information




land_type




land_area




collateral_type




collateral_subtype




repossession_status




property_type




nature_of_property




property_classification




property_ownership




property_purpose




market_value




address_type




current_usage




agreement_type




sale_deed_date




ownership_dates




disbursal_date




cersai_security_interest_creation_date




collateral_document




insurance_start_date




insurance_end_date




valuation_date_of_asset




property_usage




credit_manager
integer($int32) Credit managers are responsible for overseeing the credit granting process for a company.

sourcing_branch
integer($int32) sourcing branch

branch
string branch

disbursal_date
string($date-time) disbursal date

days_convention
string A day-count convention is the system used on debt securities, such as bonds or swaps, to calculate the amount of accrued interest or the present value when the next coupon payment is less than a full coupon period away.

recovery_type
string type of recovrery of loan

recovery_subType
string there no many way of recovery money it comes under the recovery subtype

next_installment_date
string($date-time) due date of next installment date

maturity_date
string($date-time) date of the ideal closure of the loan

asset_classification
string Asset classification, the system of assigning investments into groups or categories that have similar characteristics

tenure_convention
string it is similar to tenure like convention type

spdc_details
[...]


disbursal_details
disbursal_number




remarks




rate




disbursed_amount




enhanced_amount




reduced_amount




sanctioned_amount




adjusted_amount




net_disbursal_amount




status




disbursal_type




payment_amount




pending_amount




disbursal_breakup
breakup_number




business_partner_name




business_partner_type




other_payables




disbursal_amount




paid_amount




payment_status




pending_amount




bank_name




ifsc_code




account_number




instrument_type




disbursal_date




linked_loan_details




loan_charges
original_amount




paid_amount




charge_id




charge_rate




tax_amount




status




receivable_payable




is_tax_applicable




pending_amount




waived_amount




source_id




tax_type




amount_without_tax




charge_label




due_date




transaction_date




receipts
[...]


charges_receipt_mapping
[...]


interest_start_date
string($date-time) date of the interest start
Yes
repayment_start_date
string($date-time) Start date of overpayment is fully paid back.

repayment_mode
string mode of the repayment

agreement_date
string($date-time) Date of Agreement means the effective date of the agreement which shall not be sooner than the date on which the agreement is executed and acknowledged by both the mortgagor and mortgagee.

login_date
string($date-time) date at which loan is created

disbursal_maker_date
string($date-time) date of disbursal request making

disbursal_author_date
string($date-time) date of disbursal approved date

offer_amount
integer($int32) amout to be offer

partial_tenure
integer($int32) partial tenure of tthe loan

branch_hierarcy
JsonNode{...}


state_head
string state head

interviewer_details
[...]


psl_applicable
boolean psl flag for check whether psl applicable or not

is_repayment_contributed boolean flag to check whether repayment contribution is applied or not

interest_until integer($int64) interest till full disbursal