To book a loan, you begin by using a loan product to simulate the booking. Refer to Loan simulation for details on simulating. If the customer does not agree to the terms and conditions shown in the simulation, you have the option of simulating another loan using a different loan product. Once the customer agrees to the terms and conditions, you use the simulation to book the loan. How the funds are disbursed (in one lump sum or in stages) is determined by how you set up the loan product, and you need to call another endpoint to perform the actual disbursal.

Create loan booking

To create a loan booking, use the Book loan v2 endpoint.

The request can include the following fields.

With this data available, your system sends a POST to /lending/v2/loans with the following payload:

{
  "account_id": 514751581,
  "loan_product_id": "0ea4fe62-5512-4494-baf5-13a3044b7f7b",
  "installment_plan_id": "PL-20250708200752",
  "number_of_installments": 5,
  "metadata": {
    "risk_factor": "low"
  }
}

A successful request returns aloan_id and the loan status transitions to ACTIVE or BOOKED depending on configuration. You can later retrieve the loan_id with listing or individual retrieval endpoints. The Pismo platform generates a Loan booked event:

{
    "org_id": "TN-89e56522-726a-453e-ba6d-796b03245128",
    "external_id": "cca6041c-b57d-44cf-a203-eeea22723878",
    "loan_id": "ded913af-abc9-4769-b179-068ed6181ec5",
    "status": "BOOKED",
    "loan_product_id": "0ea4fe62-5512-4494-baf5-13a3044b7f7b",
    "account_id": 514751581,
    "amount": 1000.0,
    "start_date": "2026-05-24",
    "created_at": "2026-05-24T21:34:47"
}