L E N D I Q

Upload a bank statement. Get an underwriting decision.

The official TypeScript SDK for the LendIQ API.
Turn months of manual underwriting into a single API call.

       

Get API Key  ·  Documentation  ·  API Reference

---

7 lines. That's it.

import { LendIQ } from "@lendworks/lendiq";

const client = new LendIQ({ apiKey: "liq_live_..." });

const deal = await client.deals.create({ business_name: "Acme Trucking LLC" });
await client.documents.upload(deal.id, "./statements/chase_jan.pdf");

const result = await client.deals.get(deal.id);
console.log(result.recommendation.decision); // "approved"

That PDF just went through Gemini-powered extraction, transaction screening, tamper detection, 12-factor health scoring, and a full underwriting recommendation. Your team didn't write a single rule.

Why teams switch to LendIQ

Before LendIQ Manual PDF review (20-40 min per deal) Spreadsheet-based scoring Inconsistent underwriting criteria No tamper detection Weeks to onboard new data sources

After LendIQ Automated analysis (seconds per deal) 12-factor composite health scoring Configurable rulesets with version history PDF integrity + tampering detection One API call to process any bank statement

LendIQ vs. the alternatives

	LendIQ	Ocrolus	LendAPI	Plaid (Asset Reports)	DIY (in-house)
Upload PDF → full underwriting decision	Yes	No	Partial	No	Build it yourself
Bank statement + tax return + P&L support	All three	Statements only	Statements only	No PDFs	Depends on scope
Gemini native PDF extraction	Yes	Template OCR	Template OCR	N/A	Build it yourself
Tamper / fraud detection	Built in	Add-on	No	No	Build it yourself
Health scoring (12 sub-factors)	Built in	No	Basic	No	Build it yourself
Underwriting recommendation engine	Built in	No	Basic	No	Build it yourself
Custom rulesets with version history	Yes	No	No	No	Build it yourself
MCA position detection	Yes	No	No	No	Build it yourself
Real-time SSE streaming	Yes	Polling	Polling	Polling	Build it yourself
Typed SDKs (Python + TypeScript)	Both	Python only	None	Multiple	N/A
Pricing	Per document	Per document	Per document	Per connection	Engineering time

We don't just extract data from bank statements. We understand them — and give you a decision you can act on.

Install

npm install @lendworks/lendiq

Requires Node.js 20+. Zero runtime dependencies — uses native fetch, crypto, and fs.

Everything is typed

Every method returns a fully typed interface. Not any. Not unknown. Real types with real autocompletion.

const detail = await client.deals.get(dealId);

// IDE knows every field, every nested object, every type
detail.health.health_score;                    // number
detail.health.health_grade;                    // string
detail.recommendation.decision;                // "approved" | "conditional" | "declined"
detail.recommendation.risk_factors;            // string[]
detail.recommendation.strengths;               // string[]
detail.financials.avg_monthly_deposits;        // number
detail.mca?.mca_credit_score;                  // number | undefined

// 12 health sub-factors, individually scored and weighted
for (const [name, factor] of Object.entries(detail.health.factors)) {
  console.log(`${name}: ${factor.score}/${factor.max} (weight: ${factor.weight})`);
}

All response types are forward-compatible. New API fields are accepted automatically — your code never breaks on deploy.

Document intelligence, built in

Upload a PDF and get back structured intelligence — no OCR pipeline, no prompt engineering, no infra to manage.

const doc = await client.documents.get(docId);

// Extraction metadata
doc.extraction_method;       // "gemini_native_pdf"
doc.extraction_confidence;   // 0.94
doc.document_type;           // "bank_statement"

// Tamper detection
doc.integrity.tampering_risk_level;  // "clean" | "low" | "medium" | "high"

// Financial analysis (bank statements)
doc.analysis.average_daily_balance;   // 16215.30
doc.analysis.total_deposits;          // 48920.00
doc.analysis.health_score;            // 78.5
doc.analysis.health_grade;            // "B"

// Identity verification (driver's licenses)
doc.driver_license_analysis?.full_name;         // "John Smith"
doc.driver_license_analysis?.expiration_date;   // "2028-06-15"

// Bank verification (voided checks)
doc.voided_check_analysis?.routing_number;       // "021000021"
doc.voided_check_analysis?.is_voided;            // true

Instant analysis — no account required

Let prospects try LendIQ before they sign up. The instant endpoint processes a PDF in under 2 seconds with no data persistence.

const result = await client.instant.analyze("./statement.pdf");

console.log(result.summary.total_deposits);         // 284500.00
console.log(result.summary.total_mca_positions);    // 3
console.log(result.summary.avg_revenue_quality);    // 0.82

// Per-file breakdown
for (const file of result.results) {
  console.log(file.bank_name, file.nsf_count, file.mca_daily_obligation);
}

Real-time pipeline streaming

Watch documents process in real time. No polling.

for await (const event of client.events.stream(dealId)) {
  switch (event.event) {
    case "stage":
      console.log(`Stage: ${event.data}`);  // "classifying" → "extracting" → "screening" → "scoring"
      break;
    case "complete":
      console.log("Analysis complete");
      break;
  }
}

Auto-pagination

Forget page math. Iterate over thousands of records with a single loop.

for await (const deal of client.deals.listAll({ status: "ready" })) {
  console.log(deal.business_name, deal.health_grade);
  // Typed as DealSummary — full autocompletion
}

Error handling that doesn't suck

Every error is a typed class with the context you need to debug. No parsing strings.

import { NotFoundError, RateLimitError, ValidationError } from "@lendworks/lendiq";

try {
  await client.deals.get(dealId);
} catch (err) {
  if (err instanceof NotFoundError) {
    // err.statusCode === 404
  } else if (err instanceof RateLimitError) {
    // err.retryAfter — seconds until you can retry
  } else if (err instanceof ValidationError) {
    // err.body — full validation error details
  }
  // Every error has err.requestId for instant support correlation
}

Webhook verification in one line

import { verifySignature } from "@lendworks/lendiq/webhooks";

// HMAC-SHA256 with constant-time comparison. Timing attacks don't apply.
verifySignature(requestBody, headers["x-webhook-signature"], "whsec_...");

Built for production

Automatic retries	Exponential backoff with jitter. Honors Retry-After. Safe for mutations — POST/PUT/PATCH only retry on connection errors, never on HTTP status codes.
Idempotency	Pass an idempotency key on any write. Retry all you want.
Request tracking	Every request gets a UUID. Every error includes it. client.lastRequestId is always available.
Timeouts	Sensible defaults per operation type. TIMEOUT_READ (10s), TIMEOUT_WRITE (30s), TIMEOUT_UPLOAD (120s), TIMEOUT_REPORT (300s).
Forward compatible	All types accept unknown fields. API updates never break your build.
Dual CJS + ESM	Works with import and require. Ship anywhere.

Configuration

const client = new LendIQ({
  apiKey: "liq_live_...",          // required
  baseUrl: "https://iq.lend.works",  // default
  timeout: 30_000,                // default (ms)
  maxRetries: 2,                  // default
  logger: console,                // optional debug logging
});

25 resources. Full API coverage.

Every endpoint in the LendIQ API has a typed method in this SDK.

	Resource	What it does
Core	client.deals	CRUD, decision, evaluate, notes, stats, analytics, batch
	client.documents	Upload, bulk upload, status, reprocess, triage, classify
	client.transactions	List, correct, corrections history
	client.exports	Deal and document CSV/PDF exports
	client.rulesets	Underwriting criteria CRUD, versioned, set default
Intelligence	client.instant	Free-tier instant PDF analysis (sub-2s, no persistence)
	client.lvl	Business validation runs, call queue, SAM entities
	client.samProfiles	SAM.gov search profiles, watchers, automated triggers
	client.reviews	Document review queue, approve/correct workflow
Real-time	client.events	SSE streams for deals, org events, batch progress
	client.webhooks	Webhook config, test, delivery logs, retry
	client.notifications	In-app notifications and preferences
	client.push	Web push subscriptions
Platform	client.team	Invite, update, deactivate members
	client.keys	API key management
	client.shares	Public deal share links
	client.ingest	Bulk CRM ingest with batch tracking
	client.crm	Provider config, field mapping, bidirectional sync
	client.integrations	Slack, Teams, SMTP notification channels
	client.admin	Health, usage, error logs, DLQ, pipeline settings
	client.usage	Metering and processing time analytics
	client.oauth	Client credentials token exchange

Plus 5 sub-resources on every deal:

client.deals.comments.list(dealId);       // threaded discussion
client.deals.assignments.create(dealId);  // assign reviewers
client.deals.docRequests.create(dealId);  // request missing docs
client.deals.timeline.list(dealId);       // full activity history
client.deals.users.search({ q: "jane" }); // find team members

Retry behavior

Method	Rate limit (429)	Server error (5xx)	Connection error
GET / DELETE	Retry	Retry	Retry
POST / PUT / PATCH	—	—	Retry

Exponential backoff with jitter. 500 ms base, 30 s cap. Honors Retry-After.

We ship fast

This SDK is actively maintained by the LendIQ engineering team. We release weekly, respond to issues within 24 hours, and treat SDK quality with the same rigor as our core platform.

If something isn't right, open an issue. We'll fix it.

License

MIT — use it however you want.

Get your API key and start analyzing statements in minutes.

Built with care by the LendIQ team.