Skip to main content
POST
/
v1
/
lms
/
loans
/
{loanId}
/
repayments
Record a repayment
curl --request POST \
  --url https://{baasHost}/api/v1/lms/loans/{loanId}/repayments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "transactionAmount": 35000,
  "transactionDate": "2026-04-10",
  "paymentTypeId": 1,
  "receiptNumber": "MPESA-ABC123XYZ",
  "note": "Mobile money repayment"
}
'
{
  "status": "repayment-accepted",
  "loanId": "5c9e2b3c-4d5e-6f7a-8b9c-1d2e3f4a5b6c",
  "amount": 35000
}

Authorizations

​
Authorization
string
header
required

Bearer token from POST /generate-token. Expires ~1h; on 401, re-generate and retry once.

Path Parameters

​
loanId
string
required

Body

application/json
​
transactionAmount
number
required

Amount.

​
transactionDate
string
required

yyyy-MM-dd

​
paymentTypeId
integer
required

From GET /v1/lms/payment-types.

​
receiptNumber
string

Your unique reference; acts as idempotency key.

​
note
string

Response

200 - application/json

Repayment recorded