Create Loan

This request creates a new installment loan account.

Recipes
Create a Loan + Link a Customer
Open Recipe
Create an Installment Loan
Open Recipe
   Click here to learn more about this request


Loans are a type of lending product that can be created and associated with your borrowers. LoanPro is built to handle nearly limitless configuration options, regardless of whether you're creating installment loans, flooring loans, leases, and more.

Here are some additional details regarding building this request:

  • The Loan Creation Defaults ↗ within your tenant settings can autofill most of the information within the LoanSetup object. Take a look at the Minimum Required payload example to see which fields must be added manually.
  • When creating a loan, only the LoanSetup object is required—all other objects are optional. Additionally, only several fields within the LoanSetup object are required. Check the Minimum Required Payload example below to see which fields are required.
  • You can add optional objects to this request to include more information about the loan. For example, you can create a loan and associate Collateral, Escrow, Customers, and more by adding their respective objects. This is optional, and we explain how these objects are formatted elsewhere in this documentation. For an example of how you can include multiple objects in a request to create a new loan, take a look at the sample payloads below.

🔗 Want to create a loan and link a borrower in one request?

Add the Customers object to your payload and include the customer's ID. Take a look at our sample payload or recipe for an example.

Please note: you can only add an existing customer—you cannot create a new customer and a new loan in one request.

For an example of how creating a loan works within the UI, take a look at our Create New Loan ↗ article.

Database

For information regarding loan database tables, see the following articles:

{
    "displayId": "New Loan Display ID",
    "LoanSetup": {
        "loanAmount": "10000.00",
        "discount": "500.00",
        "underwriting": "0.00",
        "loanRate": "12.0212",
        "loanRateType": "loan.rateType.annually",
        "loanTerm": "36",
        "contractDate": "2015-05-07",
        "firstPaymentDate": "2015-05-08",
        "amountDown": "0.00",
        "reserve": "5.00",
        "salesPrice": "12000",
        "gap": "1120.",
        "warranty": "2500",
        "dealerProfit": "1000",
        "taxes": "125.25",
        "creditLimit": "15500",
        "loanClass": "loan.class.carLoan",
        "loanType": "loan.type.installment",
        "scheduleTemplate": "0",
        "discountSplit": "1",
        "paymentFrequency": "loan.frequency.monthly",
        "calcType": "loan.calcType.simpleInterest",
        "daysInYear": "loan.daysInYear.frequency",
        "interestApplication": "loan.interestApplication.betweenTransactions",
        "begEnd": "loan.begend.end",
        "firstPeriodDays": "loan.firstPeriodDays.frequency",
        "firstDayInterest": 0,
        "discountCalc": "loan.discountCalc.rebalancing",
        "diyAlt": "loan.diyAlt.no",
        "daysInPeriod": "loan.daysinperiod.24",
        "roundDecimals": "5",
        "lastAsFinal": "loan.lastasfinal.no",
        "curtailPercentBase": "loan.curtailpercentbase.loanAmount",
        "nddCalc": "loan.nddCalc.standard",
        "endInterest": "loan.endInterest.no",
        "feesPaidBy": "loan.feesPaidBy.date",
        "graceDays": "5",
        "lateFeeType": "loan.lateFee.3",
        "lateFeeAmount": "30.00",
        "lateFeePercent": "10.00",
        "lateFeeCalc": "loan.lateFeeCalc.standard",
        "lateFeePercentBase": "loan.latefeepercentbase.regular",
        "paymentDateApp": "loan.pmtdateapp.actual",
        "maxInterestAmount": "0",
        "financeChargeAsMIA": 1
    }
}
// This payload uses the tenant Loan Defaults to input the remaining loan information.

{
    "LoanSetup": {
        "loanAmount": "10000.00",
        "loanRate": "4.5",
        "loanClass": "loan.class.carLoan",
        "loanType": "loan.type.installment",
        "contractDate": "2022-05-07",
        "firstPaymentDate": "2022-05-14"
    }
}
// This payload uses the tenant Loan Defaults to input the remaining loan information.

{
    "displayId": "New Loan Display ID",
    "LoanSetup": {
        "loanAmount": "10000.00",
        "loanRate": "4.5",
        "loanClass": "loan.class.carLoan",
        "loanType": "loan.type.installment",
        "contractDate": "2022-05-07",
        "firstPaymentDate": "2022-05-14"
    },
    "Customers": { // 👈 This object will link a customer to the loan.
        "results": [
            {
                "__id": 873,
                "__setLoanRole": "loan.customerRole.primary"
            }
        ]
    }
}
// This payload includes multiple objects that hold information detailed in other pages of our documentation.

{
    "displayId": "New Loan Display ID",
    "LoanSetup": {
        "loanAmount": "10000.00",
        "discount": "500.00",
        "underwriting": "0.00",
        "loanRate": "12.0212",
        "loanRateType": "loan.rateType.annually",
        "loanTerm": "36",
        "contractDate": "2022-02-17",
        "firstPaymentDate": "2022-03-17",
        "amountDown": "0.00",
        "reserve": "5.00",
        "salesPrice": "12000",
        "gap": "1120",
        "warranty": "2500",
        "dealerProfit": "1000",
        "taxes": "125.25",
        "creditLimit": "15500",
        "loanClass": "loan.class.carLoan",
        "loanType": "loan.type.installment",
        "scheduleTemplate": "0",
        "discountSplit": "1",
        "paymentFrequency": "loan.frequency.monthly",
        "calcType": "loan.calcType.simpleInterest",
        "daysInYear": "loan.daysInYear.frequency",
        "interestApplication": "loan.interestApplication.betweenTransactions",
        "begEnd": "loan.begend.end",
        "firstPeriodDays": "loan.firstPeriodDays.frequency",
        "firstDayInterest": 0,
        "discountCalc": "loan.discountCalc.rebalancing",
        "diyAlt": "loan.diyAlt.no",
        "daysInPeriod": "loan.daysinperiod.24",
        "roundDecimals": "5",
        "lastAsFinal": "loan.lastasfinal.no",
        "curtailPercentBase": "loan.curtailpercentbase.loanAmount",
        "nddCalc": "loan.nddCalc.standard",
        "endInterest": "loan.endInterest.no",
        "feesPaidBy": "loan.feesPaidBy.date",
        "graceDays": "5",
        "lateFeeType": "loan.lateFee.3",
        "lateFeeAmount": "30.00",
        "lateFeePercent": "10.00",
        "lateFeeCalc": "loan.lateFeeCalc.standard",
        "lateFeePercentBase": "loan.latefeepercentbase.regular",
        "paymentDateApp": "loan.pmtdateapp.actual",
        "maxInterestAmount": "0",
        "financeChargeAsMIA": 1,
        "EscrowCalculators": {
            "results": [
                {
                    "entityType": "Entity.Loan",
                    "subset": 1,
                    "term": 36,
                    "total": 100,
                    "percentBase": "loan.escrowPercentBase.loanAmount",
                    "proRate1st": "loan.escrowProrateFirst.none",
                    "extendFinal": "loan.escrowextendfinal.no",
                    "disclosureLnAmtAdd": 0,
                    "paymentApplication": "loan.escrowpmtapp.percentfixed"
                }
            ]
        }
    },
    "LoanSettings": {
        "cardFeeAmount": 0,
        "cardFeeType": "loan.cardfee.types.1",
        "cardFeePercent": 0,
        "agent": 0,
        "loanStatusId": 2,
        "loanSubStatusId": 9,
        "sourceCompany": null,
        "paymentTypeDefault": 0,
        "eBilling": 0,
        "ECOACode": "loan.ecoacodes.1",
        "coBuyerECOACode": "loan.ecoacodes.0",
        "creditStatus": "loan.creditstatus.0",
        "creditBureau": "loan.creditbureau.00",
        "reportingType": "loan.reportingtype.I",
        "secured": 1,
        "autopayEnabled": 1,
        "repoDate": "",
        "closedDate": "",
        "liquidationDate": "",
        "followUpDate": "",
        "isStoplightManuallySet": 0,
        "merchantProcessorGroupId": 0,
        "repo": false,
        "closed": false,
        "liquidation": false,
        "paymentTypeDefaultText": "Company Default"
    },
    "Portfolios": {
        "results": [
            {
                "__metadata": {
                    "uri": "/api/1/odata.svc/Portfolios(id=2)",
                    "type": "Entity.Portfolio"
                }
            }
        ]
    },
    "SubPortfolios": {
        "results": [
            {
                "__metadata": {
                    "uri": "/api/1/odata.svc/Portfolios(id=31)",
                    "type": "Entity.SubPortfolio"
                }
            }
        ]
    },
    "Customers": {
        "results": [
            {
                "__id": 292,
                "__setLoanRole": "loan.customerRole.primary"
            }
        ]
    },
    "Collateral": {
        "results": [
            {
                "a": "2020",
                "b": "Honda",
                "c": "Accord",
                "d": "LE",
                "additional": "No Additional Information",
                "collateralType": "collateral.type.car",
                "vin": "1HGES839020812730",
                "distance": "13000",
                "bookValue": "24708.59",
                "color": "Blue",
                "gpsStatus": "collateral.gpsstatus.notinstalled",
                "gpsCode": "NONE",
                "licensePlate": "H3L 6N8",
                "gap": "0",
                "warranty": "0",
                "positionId": 1
            }
        ]
    }
}
Language
Authorization
Click Try It! to start a request and see the response here!