GetLoanApprovalHistoryQuery

Overview

Retrieves the complete chronological approval audit trail for a loan application, including every action taken, the stage at which it occurred, actor comments, and timestamps.

For a comment-free activity log suitable for displaying in a timeline UI, use GetLoanQuoteActivityQuery instead.

Command Structure

{
  "cmd": "GetLoanApprovalHistoryQuery",
  "data": "{\"loanRequestId\":110}"
}

Parameters

Parameter	Type	Required	Description
loanRequestId	long	Yes	ID of the loan application

Response

{
  "ok": true,
  "statusCode": "00",
  "message": "3 approval history record(s) found.",
  "outData": {
    "ApprovalHistory": [
      {
        "Id": 1,
        "LoanRequestId": 110,
        "ApproverId": 12,
        "ApprovalLevel": 0,
        "ApprovalLevelDescription": "Relationship Manager",
        "Stage": "Initiate Approval",
        "Action": "Started",
        "ActionDescription": "The approval process for the loan has been initiated",
        "Comment": "All documents verified",
        "ActionDate": "2026-06-01T09:00:00Z"
      },
      {
        "Id": 2,
        "LoanRequestId": 110,
        "ApproverId": 8,
        "ApprovalLevel": 1,
        "ApprovalLevelDescription": "Branch Manager",
        "Stage": "Branch Manager Approval",
        "Action": "Fully Approved",
        "ActionDescription": "[Process] State changed from 'Pending Approval' to 'Fully Approved' (Task: Branch Manager Approval)",
        "Comment": "Approved at branch level",
        "ActionDate": "2026-06-02T11:30:00Z"
      },
      {
        "Id": 3,
        "LoanRequestId": 110,
        "ApproverId": 4,
        "ApprovalLevel": 2,
        "ApprovalLevelDescription": "Area Manager",
        "Stage": "Area Manager Review",
        "Action": "Returned",
        "ActionDescription": "[Process] State changed from 'Fully Approved' to 'Returned' (Task: Area Manager Review)",
        "Comment": "Needs updated salary slips",
        "ActionDate": "2026-06-03T14:00:00Z"
      }
    ]
  }
}

Response Fields

Field	Description
Id	Unique record ID
LoanRequestId	Loan application ID
ApproverId	Internal user ID of the actor
ApprovalLevel	Numeric approval level (0 = RM, 1 = Branch Manager, etc.)
ApprovalLevelDescription	Human-readable level name
Stage	The task or stage name where this action occurred (e.g. Branch Manager Approval, Send Offer Letter)
Action	The outcome at this stage (e.g. Approved, Rejected, Returned, Sent, Disbursed, Started)
ActionDescription	System-generated description of what changed
Comment	Free-text comment entered by the actor
ActionDate	UTC timestamp

Stage vs Action

Stage	Action examples
Initiate Approval	Started
Branch Manager Approval	Approved, Rejected, Returned
Send Offer Letter	Sent
Set Disbursement Details	Completed
Disbursement	Disbursed
Set Collection Details	Completed

Related Commands

• GetLoanQuoteActivityQuery — comment-free activity timeline
• InitiateApproveLoanRequestCommand
• ApproveLoanRequestCommand
• RejectLoanRequestCommand
• ReturnToPreviousLevelCommand