Loan Write-off

post https://api.cloud.mbanq.com/v1/loans/{loanId}?command=writeoff

Loan write-off refers to the process of formally removing a loan from the lender’s balance sheet when it is determined that the loan is unlikely to be recovered.

Purpose: Use this API to write off a loan that is considered unrecoverable due to reasons such as long-term delinquency, bankruptcy, or other financial hardships.

Behavior: A successful response indicates that the loan has been written off in the system

time	status	user agent
Retrieving recent requests…

Loading…

Path Params

loanId

string

required

Defaults to 12

The unique identifier of the loan to be written off. Example: 1

Query Params

command

string

required

Defaults to writeoff

The command to initiate the loan write-off process. Example: writeoff

Body Params

The payload for Loan Write-off

transactionDate

string

required

Defaults to 29 March 2025

The date on which the loan write-off is performed. Format must match the dateFormat specified in the request. Example: "29 March 2025"

locale

string

The locale used for formatting the transaction date and other localized fields. Example: "en"

dateFormat

string

The format in which the transaction date is provided. Follow the standard date formatting conventions. Example: "dd MMMM yyyy"

writeoffReasonCodeId

integer

required

Defaults to 4100

The unique identifier of the reason for writing off the loan. Maps to predefined system reasons such as bankruptcy, charge-off, etc. Example: 4100

Headers

tenantId

string

required

Defaults to z01j3e71zd6zkq908vyf5861a8

The ID of your banking instance visible in the MBANQ Console.

Responses

Language

Credentials

Bearer

JWT


xxxxxxxxxx
11
1
curl --request POST \
2
     --url 'https://api.cloud.mbanq.com/v1/loans/12?command=writeoff' \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --header 'tenantId: z01j3e71zd6zkq908vyf5861a8' \
6
     --data '
7
{
8
  "transactionDate": "29 March 2025",
9
  "writeoffReasonCodeId": 4100
10
}
11
'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200The loan write-off has been successfully processed.

400The request failed due to an invalid command or missing parameters. The response provides details on what went wrong, including error messages and invalid parameter values.