Fetch Basic Details for Loan

GET Basic Loan Details for Loan Id

This SynoFin API retrieves all the essential loan information using this Loan Viewer API using Loan Id.

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

Run in Postman: `GET Loan Basic Details`

Request:

Request Type: GET

Authorization: Bearer Token

Query Parameter:

Key	Data Type	Description	Validations	Default Value	Required
loanId	Integer	Unique identity constraint	N/A	-	Yes

Response:

Success: 200 OK

Schema

~~(FOIR)~~is ~~theapplicant~~ ~~receivedfromthesource~~ ~~thecustomer~~

~~disbursed_by~~

~~loan_application_number~~

~~for~~

Attribute	Data Type	Description	Mandatory
~~Attribute~~ dpd	~~Type~~Numeric	~~Description~~Days past due	~~Mandatory~~No
~~response~~ email	String	~~Internal~~Email ~~status~~address ~~code that denotes~~of the ~~status of request~~customer	~~Yes~~No
~~data~~ address	~~Object Data~~ String	~~Object~~Customer's address	~~Response Object for the given inputs~~	~~Yes~~No
~~dpd~~ tenure	~~Integer~~Numeric	Loan tenure (months)	No ~~of Day Past Due for the Loan~~	~~Yes~~
~~email~~ foir	~~String~~	~~Applicant Email Address~~	~~Yes~~
~~address~~	~~String~~	~~Applicants Complete Address~~	~~Yes~~
~~tenure~~	~~Integer~~	~~Loan Tenure or Loan period~~	~~Yes~~
~~foir~~	~~Double~~Numeric	Fixed Obligation to Income Ratio	No
source_application_number	String	Unique identifier for the ~~eligibility~~source ofapplication	No
dealer_id	String	Dealer ID	No
loan_application_id	Numeric	Loan application ID	Yes
~~source_application_number~~ convert_to_tl_tenure	~~String~~Numeric	~~Unique~~Converted to term loan ~~identity~~tenure	No
interest_rate	Numeric	Interest rate (%)	Yes
~~dealer_id~~ original_tenure	~~integer~~Numeric	~~Unique~~Original Idloan ~~constraint~~tenure ~~for Asset dealer~~(months)	Yes
~~loan_application_id~~ ltv_ratio	~~String~~Numeric	~~Unique~~ Loan ~~identification~~to ~~for~~Value ~~the~~ratio ~~clients~~(%)	Yes
~~interest_rate~~ loan_amount	~~Double~~Numeric	~~Applied~~Loan amount (INR)	Yes
loan_tenure	Numeric	Loan tenure (months)	Yes
installments_paid	Numeric	Number of installments paid	Yes
loan_marking	Array	Details of any loan markings	No
installment_amount	Numeric	Installment amount (INR)	Yes
principal_outstanding	Numeric	Principal outstanding (INR)	Yes
customer_name	String	Customer's name	Yes
customer_father_name	String	Customer's father's name	No
phone_no	String	Customer's phone number	Yes
is_whatsapp_no	Boolean	Indicates if the phone number is for WhatsApp	No
advance_installment_count	Numeric	Count of advance installments	No
advance_installment_amount	Numeric	Amount of advance installments (INR)	No
total_overdue	Numeric	Total overdue amount (INR)	No
emi_due	Numeric	Due EMI amount (INR)	No
other_charges	Numeric	Other charges associated with the loan (INR)	No
disbursed_by	String	Name of the disbursing authority	No
source_application_identifier	String	Identifier for the source application	No
product	String	Type of product	Yes
scheme	String	Loan scheme	Yes
loan_type	String	Type of loan	No
loan_application_number	String	Unique identifier for the loan application	Yes
balance_principal	Numeric	Balance principal amount (INR)	Yes
interest_rate_monthly	Numeric	Monthly interest rate (%)	Yes
no_of_disbursement	Numeric	Number of disbursements	Yes
customer_id	Numeric	Customer ID	Yes
lending_rate	Numeric	Lending rate (%)	No
scheme_lending_rate	Numeric	Scheme lending rate (%)	No
emi_amount	Numeric	EMI amount (INR)	No
utilized_limit	Numeric	Utilized loan limit (INR)	No
dsa_name	String	Name of the Direct Selling Agent (DSA)	No
unrealized_limit_amount	Numeric	Unrealized loan limit amount (INR)	No
branch_manager	String	Branch manager's name	No
sourcing_channel	String	Channel through which the loan was sourced	No
risk_category	String	Risk category of the loan	No
sourcing_channel_type	String	Type of sourcing channel	Yes
pd_location	String	Location for probability of default calculation	No
account_classification	String	Classification of the loan account	No
drawing_power	Numeric	Drawing power (INR)	Yes
lien_mark	String	Indicates if there's a lien mark on the loan	No
lien_amount	Numeric	Amount marked as lien (INR)	No
tos	Numeric	Terms of service	No
debit_freeze	String	Indicates if there's a debit freeze on the account	No
total_freeze	String	Indicates if there's a total freeze on the account	No
pemi_count	Numeric	Count of pre-EMIs	No
loan_net_worth	Numeric	Net worth of the loan (INR)	No
start_principle_recovery	Numeric	Start principle recovery (INR)	No
caf_number	String	Customer Application Form (CAF) number	No
no_of_cheque_bounce	Numeric	Count of cheque bounces	No
dealer_code	String	Code for the dealer	No
advance_emi	Numeric	Advance EMI amount (INR)	No
advance_emi_payment_mode	String	Payment mode for advance EMI	No
total_moratorium_count	Numeric	Total count of moratorium periods	No
next_emi_amount	Numeric	Amount of the next EMI (INR)	No
moratorium_period	Numeric	Moratorium period (months)	No
advance_amount_recovery_type	String	Type of advance amount recovery	No
total_nach_bounce_count	Numeric	Total count of NACH bounces	No
total_count_of_repayment	Numeric	Total count of repayments	No
whatsapp_no	String	WhatsApp number of the customer	No
aggregated_ltv	Numeric	Aggregated Loan to Value ratio (%)	No
overline_amount	Numeric	Overline amount (INR)	No
total_number_of_bounce_count	Numeric	Total number of bounce counts	No
installment_receipt_bounce_count	Numeric	Count of bounced installment receipts	No
moratorium_type	String	Type of moratorium	No
moratorium_months	Numeric	Number of months in the moratorium period	No
account_type	String	Type of loan account	No
remarks	String	Additional remarks	No
disbursal_author_name	String	Name of the disbursing authority	No
product_type	String	Type of product	Yes
credit_manager_code	String	Code of the credit manager	No
sourcing_rm_code	String	Code of the sourcing relationship manager	No
branch_manager_code	String	Code of the branch manager	No
limit_expiry_date	String	Expiry date of the loan limit	No
repayment_van	String	Mode of repayment	No
tds_mode	String	TDS (Tax Deducted at Source) mode	No
portfolio_code	String	Code of the loan portfolio	No
area_code	String	Area code	No
credit_type	String	Type of credit	No
tenure_unit	String	Unit of loan tenure	No
sanction_by	String	Authority that sanctioned the loan	No
emi_hold	String	Indicates if there's a hold on EMI payments	No
payments_in_between	String	Details of any payments made in between EMIs	No
nature_of_loan	String	Nature of the loan	No
nature_of_business	String	Nature of the customer's business	No
psl_category	String	Priority Sector Lending (PSL) category	No
is_colending	Boolean	Indicates if the loan is co-lending	No
accounting_write_off	Boolean	Indicates if the loan is written off in accounting records	No
psl_sub_category	String	Sub-category of Priority Sector Lending (PSL)	No
repayment	String	Details of repayment terms	No
product_category	String	Category of the loan product	No
product_sub_category	String	Sub-category of the loan product	No
bulk_upload_id	String	ID of the bulk upload	No
existing_lan	String	Details of any existing loans	No
psl_name	String	Name of the Priority Sector Lending (PSL)	No
psl_remarks	String	Remarks related to Priority Sector Lending (PSL)	No
customer_branch	String	Branch where the customer is associated	No
customer_profile	String	URL to the customer's profile image	No
disbursal_status	String	Status of the loan disbursal	Yes
sourcing_rm	String	Name of the sourcing relationship manager	No
loan_status	String	Status of the loan	Yes
~~original_tenure~~ credit_manager	~~integer~~String	~~Initial~~Name ~~tenure for~~of the ~~loan~~credit manager	Yes
~~ltv_ratio~~ sourcing_branch	~~Interger~~String	~~Loan~~Branch tofrom ~~Value~~which orthe loan ~~against~~was ~~Collateral~~sourced	Yes
~~loan_amount~~ disbursal_date	~~Interger~~String	~~Loan~~Date ~~Amount~~of ~~that~~loan ~~is issued~~disbursal	Yes
~~loan_tenure~~ maturity_date	~~Interger~~String	~~Loan~~Date ~~Tenure~~of orloan ~~the Loan duration~~maturity	Yes
~~installments_paid~~ asset_classification	~~Interger~~String	~~Number~~Classification ~~The installment that are paid for by~~of the ~~customer~~loan asset	Yes
~~loan_marking~~ tenure_convention	String	~~Loan~~Convention ~~tag~~followed iffor ~~applicable~~loan tenure	No
interest_start_date	String	Start date for interest calculation	Yes
~~installment_amount~~ repayment_start_date	~~Interger~~String	Start date for loan repayment	Yes
~~principal_outstanding~~ repayment_mode	~~Interger~~String	Mode of loan repayment	No
disbursed_start_date	String	Start date for loan disbursal	Yes
~~customer_name~~ disbursed_final_date	String	Final date for loan disbursal	Yes
~~phone_no~~ agreement_date	~~Interger~~String	Date of agreement	No
string_interest_rate	String	Interest rate as a string	Yes
~~is_whatsapp_no~~ string_interest_rate_monthly	~~Interger~~String	Monthly interest rate as a string	Yes
~~advance_installment_count~~ rate_type	~~Interger~~String	~~Advance~~Type ~~Installment~~of ~~paid~~interest byrate	No
total_limit	Numeric	Total loan limit	Yes
~~advance_installment_amount~~ remaining_limit	~~Interger~~Numeric	Remaining loan limit	Yes
~~total_overdue~~ login_date	~~Interger~~String	Date of loan application	Yes
~~emi_due~~ total_due_amount	~~Interger~~Numeric	Total amount due	~~Yes~~No
~~other_charges~~ irr	~~Interger~~Numeric	Internal Rate of Return (IRR)	~~Yes~~No
balance_tenure	Numeric	Remaining tenure (months)	No
recovery_type	String	Type of recovery	~~Yes~~No
~~source_application_identifier~~ recovery_sub_type	String	Sub-type of recovery	~~Yes~~No
~~product~~ relationship_with_applicant	String	Relationship of the applicant with the loan	~~Yes~~No
~~scheme~~ customer_nationality	String	Nationality of the customer	~~Yes~~No
~~loan_type~~ segement	String	Segment of the loan	~~Yes~~No
offer_amount	Numeric	Offered loan amount	No
partial_tenure	Numeric	Partial tenure (months)	No
subvention_amount	Numeric	Subvention amount (INR)	No
subvention_amount_without_tax	Numeric	Subvention amount without tax (INR)	No
over_line	Numeric	Overline amount (INR)	No
partner	String	Partner associated with the loan	No
~~balance_principal~~ subvention_tax_amount	Numeric	Subvention tax amount (INR)	No
~~interest_rate_monthly~~ subvention_type	String	Type of subvention	No
~~no_of_disbursement~~ state_head	String	Head of the state	No
~~customer_id~~ branch_hierarcy	String	Hierarchy of the branch	No
~~lending_rate~~ cost_of_asset	Numeric	~~Rate~~Cost of ~~Interest~~the ~~against~~asset ~~loan~~(INR)	No
~~scheme_lending_rate~~ customer_irr	Numeric	Customer's Internal Rate of Return (IRR)	No
~~emi_amount~~ over_due	Numeric	Overdue amount (INR)	No
~~utilized_limit~~ sourcing_rm_name	String	~~Limit~~Name ~~utilized by~~of the ~~client~~sourcing ~~against~~relationship ~~sanctioned amount~~manager	No
~~dsa_name~~ sourcing_supervisor	String	Name of the sourcing supervisor	No
~~unrealized_limit_amount~~ cancellation_date	String	~~Limit~~Date ~~that~~of isloan ~~not initiated~~cancellation	No
~~applied_amount~~ loan_closure_date	String	Date of loan closure	No
~~branch_manager~~ dpd_effective_date	String	Effective date of DPD	No
~~sourcing_channel~~ agreed_amount	Numeric
~~risk_category~~
~~sourcing_channel_type~~
~~pd_location~~		~~Applicant location for the asset classification~~
~~account_classification~~
~~drawing_power~~
~~lien_mark~~		~~The borrower has permitted the lender to do so in accordance with the recovery of money associated with the mutual fund.~~
~~lien_amount~~		~~Locked or frozen amount available in your account that is not accessible for a specific time frame~~
~~tos~~
~~debit_freeze~~
~~total_freeze~~
~~pemi_count~~
~~loan_net_worth~~
~~start_principle_recovery~~
~~caf_number~~		~~Customer application form number~~
~~no_of_cheque_bounce~~
~~dealer_code~~
~~advance_interest~~
~~advance_emi~~
~~advance_emi_payment_mode~~
~~advance_interest_payment_mode~~
~~total_moratorium_count~~
~~next_emi_amount~~
~~grace_period~~
~~delinquency~~
~~moratorium_period~~
~~advance_amount_recovery_type~~
~~total_nach_bounce_count~~
~~total_count_of_repayment~~
~~whatsapp_no~~
~~aggregated_ltv~~
~~overline_amount~~
~~total_number_of_bounce_count~~
~~moratorium_type~~
~~moratorium_months~~
~~loan_purpose~~
~~account_type~~
~~remarks~~
~~customer_branch~~
~~customer_profile~~
~~disbursal_status~~
~~sourcing_rm~~
~~loan_status~~
~~credit_manager~~
~~sourcing_branch~~
~~disbursal_date~~
~~maturity_date~~
~~asset_classification~~
~~tenure_convention~~
~~interest_start_date~~
~~repayment_start_date~~
~~repayment_mode~~
~~disbursed_start_date~~
~~disbursed_final_date~~
~~agreement_date~~
~~string_interest_rate~~
~~string_interest_rate_monthly~~
~~rate_type~~
~~total_limit~~
~~remaining_limit~~
~~login_date~~
~~total_due_amount~~
~~irr~~
~~balance_tenure~~
~~recovery_type~~
~~recovery_sub_type~~
~~relationship_with_applicant~~
~~customer_nationality~~
~~segement~~
~~offer_amount~~
~~partial_tenure~~
~~subvention_amount~~
~~over_line~~
~~partner~~
~~subvention_tax_amount~~
~~subvention_type~~
~~state_head~~
~~branch_hierarcy~~
~~cost_of_asset~~
~~product_type~~
~~customer_irr~~
~~over_due~~	~~Double~~	~~Overdue amount for the~~Agreed loan ~~if applied~~	~~Yes~~
~~sourcing_rm_name~~	~~String~~	~~Full Namr of the Sourcing Regional Manager~~	~~Yes~~
~~sourcing_supervisor~~	~~String~~	~~Full name of the Sourcing Supervisor~~	~~Yes~~
~~cancellation_date~~	~~Date~~	~~Loan cancellation date~~	~~Yes~~
~~loan_closure_date~~	~~Date~~	~~Loan Closing date~~	~~Yes~~
~~dpd_effective_date~~	~~Date~~	~~Date starting for DPD~~
~~agreed_amount~~	~~Double~~	~~Loan Sanction~~ amount	Yes
~~error~~ emi_cycle	~~Object~~Numeric	~~Internal~~EMI ~~error~~cycle ~~object~~(days)	Yes
foreclosed_amount	Numeric	Foreclosed amount (INR)	Yes
limit_start_date	String	Start date of the ~~given~~loan ~~inputs~~limit	Yes
limit_end_date	String	End date of the loan limit	Yes
first_name	String	First name of the customer	No
last_name	String	Last name of the customer	No
middle_name	String	Middle name of the customer	No
rbi_activity_classification	String	RBI activity classification	No
total_outstanding_receivables	Numeric	Total outstanding receivables (INR)	No
payment_on_hold_status	Boolean	Indicates if payment is on hold	No
payment_on_hold_reason	String	Reason for holding payment	No
pending_tranche_amount	Numeric	Pending tranche amount (INR)	No
loan_relation_details	Array	Details of loan relationships	No
is_adhoc	String	Indicates if the loan is ad-hoc	No
is_subvention	String	Indicates if subvention is applied to the loan	No
maturity_closure_date	String	Date of maturity closure	No
anchor_rate	Numeric	Anchor rate	No
spread	Numeric	Spread	Yes

Body

{
  "response": true,
  "data": {
    "dpd": 0,
    "email": "string",
    "address": "string",
    "tenure": 0,
    "foir": 0,
    "source_application_number": "string",
    "dealer_id": null,
    "loan_application_id": 0,
    "interest_rate": 0,
    "original_tenure": 0,
    "ltv_ratio": 0,
    "loan_amount": 0,
    "loan_tenure": 0,
    "installments_paid": 0,
    "loan_marking": [],
    "installment_amount": 0,
    "principal_outstanding": 0,
    "customer_name": "string",
    "phone_no": "string",
    "is_whatsapp_no": null,
    "advance_installment_count": 0,
    "advance_installment_amount": 0,
    "total_overdue": 0,
    "emi_due": 0,
    "other_charges": 0,
    "disbursed_by": null,
    "source_application_identifier": null,
    "product": "string",
    "scheme": "string",
    "loan_type": null,
    "loan_application_number": "string",
    "balance_principal": 0,
    "interest_rate_monthly": null,
    "no_of_disbursement": 0,
    "customer_id": 0,
    "lending_rate": null,
    "scheme_lending_rate": null,
    "emi_amount": 0,
    "utilized_limit": 0,
    "dsa_name": null,
    "unrealized_limit_amount": null,
    "applied_amount": null,
    "branch_manager": "",
    "sourcing_channel": null,
    "risk_category": null,
    "sourcing_channel_type": null,
    "pd_location": null,
    "account_classification": "",
    "drawing_power": 0,
    "lien_mark": "string",
    "lien_amount": 0,
    "tos": 0,
    "debit_freeze": "No",
    "total_freeze": "No",
    "pemi_count": 0,
    "loan_net_worth": null,
    "start_principle_recovery": true,
    "caf_number": null,
    "no_of_cheque_bounce": 0,
    "dealer_code": null,
    "advance_interest": null,
    "advance_emi": null,
    "advance_emi_payment_mode": null,
    "advance_interest_payment_mode": null,
    "total_moratorium_count": 0,
    "next_emi_amount": null,
    "grace_period": null,
    "delinquency": null,
    "moratorium_period": null,
    "advance_amount_recovery_type": null,
    "total_nach_bounce_count": 0,
    "total_count_of_repayment": 0,
    "whatsapp_no": null,
    "aggregated_ltv": null,
    "overline_amount": 0,
    "total_number_of_bounce_count": 0,
    "moratorium_type": null,
    "moratorium_months": null,
    "loan_purpose": null,
    "account_type": null,
    "remarks": null,
    "customer_branch": null,
    "customer_profile": "",
    "disbursal_status": "string",
    "sourcing_rm": null,
    "loan_status": "string",
    "credit_manager": null,
    "sourcing_branch": "string",
    "disbursal_date": "dd/MM/yyyy",
    "maturity_date": "dd/MM/yyyy",
    "asset_classification": null,
    "tenure_convention": null,
    "interest_start_date": "dd/MM/yyyy",
    "repayment_start_date": "dd/MM/yyyy",
    "repayment_mode": "DRE",
    "disbursed_start_date": "dd/MM/yyyy",
    "disbursed_final_date": "dd/MM/yyyy",
    "agreement_date": "dd/MM/yyyy",
    "string_interest_rate": "String",
    "string_interest_rate_monthly": "string",
    "rate_type": null,
    "total_limit": null,
    "remaining_limit": 0,
    "login_date": null,
    "total_due_amount": 0,
    "irr": 0,
    "balance_tenure": 0,
    "recovery_type": null,
    "recovery_sub_type": "0",
    "relationship_with_applicant": null,
    "customer_nationality": null,
    "segement": null,
    "offer_amount": null,
    "partial_tenure": null,
    "subvention_amount": null,
    "over_line": null,
    "partner": null,
    "subvention_tax_amount": null,
    "subvention_type": null,
    "state_head": "",
    "branch_hierarcy": null,
    "cost_of_asset": 0,
    "product_type": "string",
    "customer_irr": 0,
    "over_due": null,
    "sourcing_rm_name": null,
    "sourcing_supervisor": null,
    "cancellation_date": null,
    "loan_closure_date": "dd/MM/yyyy",
    "dpd_effective_date": null,
    "agreed_amount": 0
  },
  "error": null
}

Status Code: 400 BAD REQUEST

Schema

Attribute		Type	Description	Mandatory
response		String	Internal status code that denotes the status of request	Yes
data		Object	Response Object for the given inputs	No
error	Object Data	Object	Internal error object for the given inputs	Yes
	code	integer	Internal error code for API	Yes
	text	String	Error message for the API	No
	detail	String	Reason / Detail for the cause of error	No

Body

Expected messages as per Status API :

Error Code	Description
107001	An Exception occurred in saving data

{
    "response": false,
    "data": null,
    "error": {
        "code": 0,
        "text": "string",
        "detail": "string"
    }
}

Unauthorized: 401

Note: If the API is not authorized with the Token or if the authorization token has expired, this error is going to show up.

Body

{
    "code": 401,
    "message": "auth fail, you can retry!"
}

Fetch Basic Details for Loan

GET Basic Loan Details for Loan Id

Run in Postman: GET Loan Basic Details

Request:

Query Parameter:

Response:

Success: 200 OK

Status Code: 400 BAD REQUEST

Unauthorized: 401

Run in Postman: `GET Loan Basic Details`