You can book a loan by finalizing the borrower’s approval and officially creating the loan, which makes the loan active and ready for them to use.

Prerequisites

Before booking a loan, you must show a potential borrower the loan terms though a loan simulation. Once they agree to the terms and conditions, you reference this simulation in the payload when booking the loan. For more information, refer to Simulate loans.

Book a loan

Use the Book loan endpoint to book a loan.

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 a loan_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"
}