Skip to main content

​
Quickstart

Run a minimal Truv integration end-to-end in Python, Ruby, Go, Node.js, or C#. Create a user, launch Bridge, receive a webhook, and fetch a report. Use this to verify your API keys work and understand the core flow before building anything.

Quickstart

Clone, configure, and run in minutes with Docker. Five languages available.

​
Demo apps

The demo-apps repo implements five real integration patterns. Each makes live API calls, launches Bridge, receives webhooks, and fetches reports. Pick the demo that matches your use case and use it as a starting point.

​
Prerequisites

​
Setup

git clone https://github.com/truvhq/demo-apps.git
cd demo-apps
npm install
cp .env.example .env
Open .env and add your Truv API credentials: 
API_CLIENT_ID=your_client_id
API_SECRET=your_secret
Start ngrok in a separate terminal to receive webhooks: 
ngrok http 3000
Copy the https://...ngrok-free.dev URL into .env: 
NGROK_URL=https://your-tunnel.ngrok-free.dev
Run the app: 
npm start        # Express server on :3000
npm run dev      # Vite dev server on :5173
Open http://localhost:5173 and pick a demo.

​
Choose a demo

DemoPatternProducts
ApplicationEmbedded OrdersVOIE, VOE, VOA
Follow-upEmbedded Orders (multi-task)VOIE, VOE, VOA
Consumer CreditBridge WidgetDDS, PLL, VOIE
Verifier PortalHosted OrdersVOIE, VOE
Document ProcessingDocument ProcessingDocument extraction

​
Which demo fits your use case?

If you’re building…Start with
Mortgage origination (purchase, refi, HELOC)Application
Consumer lending (auto, personal, BNPL)Application
Co-borrower or multi-product verificationFollow-up
Account funding / direct deposit captureConsumer Credit
Earned wage access or loan repaymentConsumer Credit
Loan processor or caseworker portalVerifier Portal
Background screening / pre-employmentVerifier Portal
Benefits eligibility (SNAP, Medicaid, TANF)Application or Verifier Portal
Pay stub / W-2 / tax return processingDocument Processing
See Test Credentials for sandbox login scenarios.