Lending & Working Capital
FCA CONC, CCA 1974 — Consumer credit, business finance, and mortgage case packaging
Quick Reference
result = agent.check(case_type="personal_loan",depth="standard",documents=[open("application.pdf", "rb")],reference="LND-2026-00293",)
Case Types
Consumer Credit
| Name | API ID | Description |
|---|---|---|
| Personal Loan | personal_loan | Unsecured personal lending |
| Credit Card | credit_card | Applications and limit increases |
| Hire Purchase | hire_purchase | Asset finance and HP agreements |
| Motor Finance | motor_finance | PCP, HP, and personal contract hire |
Working Capital / Business Finance
| Name | API ID | Description |
|---|---|---|
| Asset Finance | asset_finance | Equipment and machinery financing |
| Invoice Finance | invoice_finance | Invoice factoring and discounting |
| Unsecured Business Loan | unsecured_business_loan | Business lending without property security |
| Secured Business Loan | secured_business_loan | Business lending secured against property |
| Merchant Cash Advance | merchant_cash_advance | Revenue-based business funding |
| VAT Loan | vat_loan | Short-term VAT payment financing |
| Trade Finance | trade_finance | Import/export and supply chain financing |
The Lending cluster also supports mortgage case packaging workflows for lenders. See the AI Packager recipe for details.
Modifiers
| Name | API ID | Description |
|---|---|---|
| Vulnerable Customer | vulnerable_customer | Adds vulnerability indicators check and enhanced suitability assessment |
| High DTI | high_dti | Applicants with debt-to-income above threshold — adds enhanced affordability |
| Refinance | refinance | Adds existing debt comparison and refinancing rationale checks |
| Self Employed | self_employed | Enhanced income verification for self-employed applicants |
| New Start Business | new_start | Projections accepted in lieu of accounts/bank statements |
| Adverse Credit | adverse_credit | Enhanced assessment for applicants with credit history issues |
Document Requirements
Typical documents required per working capital case type.
| Case Type | Required Documents |
|---|---|
| Asset Finance | KYC, Fact Find, Signed Terms, Loan offer docs, Full accounts, 3 months bank statements |
| Invoice Finance | KYC, Fact Find, Signed Terms, Full accounts, Debtor book |
| Unsecured Business Loan | KYC, Fact Find, Signed Terms, Full accounts, 3 months bank statements |
| Secured Business Loan | KYC, Fact Find, Signed Terms, Property valuation, Bank statements |
| Merchant Cash Advance | KYC, Fact Find, Signed Terms, Card terminal statement, 3 months bank statements |
| VAT Loan | KYC, Fact Find, Signed Terms, VAT bill, Full accounts |
Depths
| Name | API ID | Duration | Scoring | Price | Description |
|---|---|---|---|---|---|
| Affordability Check | affordability_check | ~30s | pass_fail | £0.50 | Basic affordability calculation, income vs commitments |
| Standard | standard | ~2 min | rag | £3.00 | Full responsible lending review — affordability, creditworthiness, suitability |
| Comprehensive | comprehensive | ~3 min | rag | £8.00 | Standard + cross-portfolio analysis, persistent debt indicators |
Scoring Modes
pass_fail
Used by affordability_check. Each check returns pass or fail. The overall result is pass if all checks pass, or fail if any check fails.
rag
Used by standard and comprehensive. Each check returns green (meets responsible lending criteria), amber (borderline, needs review), or red (does not meet criteria). Amber and red findings include descriptions and remedial actions. The overall triage is the worst-case result across all checks.
Worked Example: Personal Loan with Vulnerability
Personal loan with vulnerable customer modifier at comprehensive depth.
Request
from curvestone import Agentagent = Agent()result = agent.check(case_type="personal_loan",depth="comprehensive",modifiers=["vulnerable_customer"],documents=[open("application_form.pdf", "rb"),open("income_evidence.pdf", "rb"),],reference="LND-2026-00293",)
Response
1{2 "id": "job_4wNr8kHvP1",3 "type": "check",4 "status": "completed",5 "triage": "amber",6 "reference": "LND-2026-00293",7 "processing_time": "162s",8 "scoring": "rag",9 "checks": [10 { "name": "Affordability Assessment", "triage": "green" },11 { "name": "Creditworthiness", "triage": "green" },12 { "name": "Vulnerability Assessment", "triage": "amber" },13 { "name": "Responsible Lending", "triage": "green" },14 { "name": "Persistent Debt Risk", "triage": "green" }15 ],16 "findings": [17 {18 "severity": "amber",19 "check": "Vulnerability Assessment",20 "finding": "Application notes indicate the customer recently experienced a significant life event (bereavement). The file does not document how vulnerability was assessed or what additional support was offered during the application process.",21 "remedial_action": "Document the vulnerability assessment conducted, including what indicators were identified and what adjustments were made to the sales process. Record any additional support offered to the customer in line with FCA CONC 2.10 guidance."22 }23 ],24 "cost": "£8.00"25}
Ask
Use POST /ask to ask natural-language questions about a completed lending job, a document, or product criteria.
Example questions
- →Does this applicant meet the criteria for an unsecured business loan?
- →What documents are still missing for this asset finance application?
- →Which working capital products suit a business with 12 months of trading history?
- →Summarise the risk factors for this merchant cash advance application.
- →What are the key differences between invoice finance and asset finance eligibility?
Questions can reference a job_id for context-aware answers grounded in the original documents and findings. £0.05 per turn.
Monitor
Use POST /monitor to set up recurring watches relevant to the lending cluster.
| Monitor type | What it watches | Typical schedule |
|---|---|---|
| criteria_update | Lender product criteria and eligibility changes | every_15_days |
| regulation_change | FCA CONC and CCA 1974 updates | weekly |
| website_change | Lender portals and working capital product pages | daily |
Monitors can trigger downstream actions via on_finding — e.g. automatically re-run a check when lender criteria change. £15/month per monitor.