All templates
State template

Loan approval workflow

Multi-stage loan application with verification and decision states.

A loan approval process is a sequence of verifications and decisions that move an application through states: submitted, verified, checked, reviewed, and finally approved or denied. This template maps the complete lifecycle, including the feedback loops where applications must go back for more documentation or are rejected outright.

The key insight is that an application is always in one state, and only certain transitions are legal. A denied application doesn't go back to verification — it's terminal. An approved application that the applicant declines goes to funding, not back to review. State diagrams make these invariants explicit and visible to the whole team.

When to use this template

  • Compliance audits — state diagrams are the standard tool for documenting regulated workflows. Regulators expect to see the complete state space and all transitions.
  • New lending product launch — map your approval process before building the backend state machine. Get legal and operations alignment first.
  • Process bottleneck analysis — add duration metadata to each state transition to find where applications spend the most time and where you should invest in automation.

How to adapt it

Customize the states and transitions to match your lending rules:

  • Add specialized verification states — insert 'Fraud_Check', 'Background_Check', or 'Collateral_Appraisal' between income verification and underwriting review.
  • Create parallel approval tracks — add a separate 'Quick_Approval_Track' for low-risk applicants to bypass full underwriting.
  • Model conditional routing — add a state like 'Loan_Amount_Review' with transitions to different underwriting levels based on requested amount.

Visual edits regenerate clean code suitable for both technical design docs and compliance documentation.

Mermaid code

Copy it anywhere Mermaid is supported — GitHub, Notion, or your docs.

stateDiagram-v2
  [*] --> Application_Submitted
  Application_Submitted --> Document_Verification: Documents received
  Document_Verification --> Credit_Check: All documents valid
  Document_Check_Failed: Missing documents
  Document_Verification --> Document_Check_Failed: Documents invalid
  Document_Check_Failed --> Application_Submitted: Resubmit
  Credit_Check --> Income_Verification: Credit score acceptable
  Credit_Check --> Application_Rejected: Poor credit history
  Income_Verification --> Underwriting_Review: Income verified
  Income_Verification --> Income_Verification: Request more docs
  Underwriting_Review --> Loan_Committee: Ready for decision
  Loan_Committee --> Loan_Approved: Meets all criteria
  Loan_Committee --> Loan_Denied: Does not meet criteria
  Loan_Approved --> Funding: Applicant accepts terms
  Loan_Denied --> [*]
  Application_Rejected --> [*]
  Funding --> [*]

Frequently asked questions

What is a loan approval workflow state diagram?
It visualizes every state a loan application moves through: submission, document verification, credit checks, income verification, underwriting review, committee decision, and either approval with funding or denial. Each transition represents a completed check or decision gate.
Why use a state diagram instead of a flowchart for loan approval?
State diagrams explicitly model the application's lifecycle — which states it can transition to, and which are terminal (approved, denied). Flowcharts show steps; state diagrams show legal transitions. When regulations require audit trails, a state diagram is the right mental model.
How do I customize this for my lending product?
Rename states to match your process: add specialized states like 'Fraud_Check', 'Collateral_Appraisal', or 'Legal_Review'. Remove states you don't need. Visual edits regenerate clean Mermaid code you can paste into compliance docs or system design docs.
What should I track at each state transition?
Log the timestamp, the person/system that triggered the transition, and the decision criteria. This audit trail is both a compliance requirement and the source of truth when a customer asks 'why was I denied?' or 'where is my application?'

Related templates