Docs

How InsightCredit is put together

Configuration, the data it reads and the API behind every screen.

Getting started

How a deployment fits together

A Python (FastAPI) API, a React app and PostgreSQL. InsightCredit reads the bank’s systems from a source schema and keeps its cases, documents read, spreads, checks, grades, exceptions, decisions and agent runs in its own schema.

1

Connect the sources

Point CREDIT_SOURCE_SCHEMA at your applications, borrowers, documents, collateral, loans, covenants and reporting, or at views over them.

2

Set the policy

The credit policy controls in Rules Studio, delegated authorities, tolerances and the house limit.

3

Add people

Analysts, credit officers, senior credit officers, administrators and viewers, through the identity service or your SSO.

Configuration

The settings that matter

Set in the environment of the API. Every default in the demo is illustrative.

VariableWhat it sets
INSIGHT_DATABASE_URL, INSIGHT_DATABASE_SCHEMAPostgreSQL connection and the schema InsightCredit keeps its own work in (default credit); the password through INSIGHT_DATABASE_SECRET or INSIGHT_DATABASE_PASSWORD
CREDIT_SOURCE_SCHEMAThe schema holding the bank’s systems: applications, borrowers, principals, documents, collateral, loans, covenants and quarterly reporting. Read only (default credit_data)
CREDIT_AUTHORITY_OFFICER_USD, CREDIT_AUTHORITY_SENIOR_USDDelegated authority by relationship exposure: a credit officer’s limit and a senior credit officer’s (2,500,000 and 10,000,000 in the demo, illustrative); above that, the credit committee
CREDIT_GROUP_HOUSE_LIMIT_USDThe house limit for a related-party group (otherwise the bank profile’s; 15,000,000 in the demo, illustrative)
CREDIT_TOL_RECEIVABLES, CREDIT_TOL_PAYABLES, CREDIT_TOL_TAX_REVENUE, CREDIT_TOL_RENT_ROLLReconciliation tolerances (0.10, 0.10, 0.10 and 0.15 in the demo)
CREDIT_MIN_DEPOSIT_RATIOThe lowest annualized deposits to revenue before a warning (0.75)
CREDIT_APPRAISAL_MAX_DAYS, CREDIT_PFS_MAX_DAYS, CREDIT_STATEMENT_MAX_DAYSHow old an appraisal, a personal financial statement and the latest fiscal year may be (365, 365 and 456 days)
CREDIT_AGENTS_LLM, CREDIT_CLAUDE_MODEL, CREDIT_AGENT_MODELWhether the agents use a language model, and which; 0 means rules only
CREDIT_COPILOT_LLMThe same for the copilot; off, it answers with the facts
CREDIT_AGENTS_MAX_LEVELThe autonomy ceiling for every agent in the tenant (L2 at most)
CREDIT_COMMS_LIVE, CREDIT_APP_URLWhether sending a request delivers it to the borrower, and the address the borrower’s link points to
CREDIT_CORS_ORIGINSThe web origins allowed to call the API
Data

What InsightCredit reads

The demo builds these tables for a fictional bank; a deployment maps them to the bank’s systems.

Source tableWhat it holds
borrowers, principals, borrower_principalsBusiness borrowers and prospects, their owners and guarantors, and who guarantees what
applicationsCredit requests from the relationship managers: product, amount, term, amortization, indicative rate, purpose
documentsThe files: statements, returns, bank statements, agings, rent rolls, personal statements and appraisals
financial_statements, tax_returns, bank_statements, ar_agings, ap_agings, rent_rolls, personal_financial_statements, appraisalsThe demo’s generated source figures behind those files (InsightCredit itself reads the documents)
collateralPledged real estate, equipment, receivables and inventory, with lien position
loans, covenants, quarterly_reportingThe loan book, each loan’s covenants, and the quarterly packages monitoring tests
related_groupsBorrowers under common ownership
industry_risk, bank_profileThe grade’s industry list and the bank’s profile, including the house limit
API

Every screen is an API call

Authenticated with the session’s bearer token; the borrower’s request page is the only public route.

AreaEndpoints (under /api/credit)
Reference and intakeGET /reference, GET /applications, POST /cases (from an application, or a loan for an annual review)
CasesGET /cases, GET /cases/{id}, PUT /cases/{id}/owner, GET /cases/{id}/timeline, POST /cases/{id}/steps/{step} (read, spread, verify, collateral, grade, policy)
DocumentsGET|POST /cases/{id}/documents, GET /documents/{id}, GET /documents/{id}/file
Spread and checksGET /cases/{id}/spread, GET /cases/{id}/checks, POST /checks/{id}
Collateral, exposure and gradeGET /cases/{id}/collateral, POST /collateral/{id}/order-appraisal, GET /cases/{id}/exposure, GET /groups, GET /cases/{id}/grade, POST /cases/{id}/grade/override
Exceptions and memoGET /cases/{id}/exceptions, POST /exceptions/{id}, POST /cases/{id}/memo
RequestsGET|POST /cases/{id}/requests, PUT /requests/{id}, POST /requests/{id}/send, POST /requests/{id}/cancel; the borrower’s page uses GET|POST /api/public/request/{token}
DecisionPOST /cases/{id}/submit, POST /cases/{id}/decide, GET /cases/{id}/decision
The book and monitoringGET /book, GET /covenants, GET /watchlist, POST /watchlist/{id}/clear, GET /reporting/late, GET /reviews, POST /monitoring/run
Agents (under /api/credit_agents)POST /cases/{id}/run, GET /cases/{id}, POST /portfolio/run, GET /portfolio, GET /prepared, POST /prepared/{id}/answer, GET /autonomy, PUT /autonomy/{agent}/level, GET /activity, GET /metrics
Rules Studio (under /api/credit_rules)The credit policy controls: read by anyone signed in, changed by a credit officer or an administrator
HealthGET /api/ready

Questions about a deployment?

Tell us about your systems and we’ll map them to InsightCredit’s sources with you.

Request a demo