CreateMultipleGuarantorInformationCommand
Overview​
Adds multiple guarantors to a loan application in a single request. Each guarantor entry is validated and persisted independently.
Command Structure​
{
"cmd": "CreateMultipleGuarantorInformationCommand",
"data": "{\"loanQuoteId\":110,\"guarantors\":[{\"name\":\"Bola Tinubu\",\"emailAddress\":\"bola@example.com\",\"mobileNumber\":\"08098765432\",\"relationship\":\"Friend\",\"address\":\"12 Marina, Lagos\",\"homeAddress\":\"12 Marina, Lagos\",\"officeAddress\":\"Tower 1, VI, Lagos\",\"designation\":\"Director\",\"verificationDetails\":{\"verificationStatus\":\"Pending\",\"verificationComment\":\"\"}},{\"name\":\"Ngozi Obi\",\"emailAddress\":\"ngozi@example.com\",\"mobileNumber\":\"08011112222\",\"relationship\":\"Colleague\",\"address\":\"5 Awolowo Rd, Ikoyi\",\"homeAddress\":\"5 Awolowo Rd, Ikoyi\",\"officeAddress\":\"Plot 23 Adeola Odeku, VI\",\"designation\":\"Senior Analyst\",\"verificationDetails\":{\"verificationStatus\":\"Pending\",\"verificationComment\":\"\"}}]}"
}
Parameters​
| Parameter | Type | Required | Description |
|---|---|---|---|
loanQuoteId | long | Yes | Loan application ID |
guarantors | array | Yes | Array of guarantor objects (see below) |
Guarantor Object​
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Full name of guarantor |
emailAddress | string | Yes | Email address |
mobileNumber | string | Yes | Phone number |
relationship | string | Yes | Relationship to applicant |
address | string | Yes | Residential address |
homeAddress | string | No | Guarantor's home address |
officeAddress | string | No | Guarantor's office/work address |
designation | string | No | Guarantor's job title or designation |
verificationDetails.verificationStatus | string | Yes | Initial status — typically "Pending" |
verificationDetails.verificationComment | string | Yes | Comment (can be empty) |
Process​
- Validates loan quote exists
- Iterates through each guarantor object
- Creates a
GuarantorInformationrecord for each, linked to the loan - Sets verification status to
Pending (0)by default - Persists all records
Response​
{
"ok": true,
"statusCode": "00",
"message": "Guarantors added successfully.",
"outData": {
"Guarantors": [
{ "GuarantorId": 21, "Name": "Bola Tinubu" },
{ "GuarantorId": 22, "Name": "Ngozi Obi" }
]
}
}