Overview
TruthStack is a comprehensive verification platform for MSME lending, providing real-time verification and AI-powered creditworthiness scoring.
Real-time Verification
TruthScore AI
PSB Xchange
Fraud Detection
Batch Operations
Analytics Dashboard
Base URL
# Production
https://api.truthstack.io/api/v3
# Local Development
http://localhost:8100/api/v3
Authentication
TruthStack uses OAuth2 Client Credentials flow:
curl -X POST http://localhost:8100/api/v3/auth/token \
-d "grant_type=client_credentials" \
-d "client_id=YOUR_CLIENT_ID" \
-d "client_secret=YOUR_CLIENT_SECRET"
Use the returned token in subsequent requests:
Authorization: Bearer <access_token>
API Endpoints
E00 - Lender Onboarding
| POST | /lenders | Register new lender |
| POST | /auth/keys | Generate API credentials |
| POST | /auth/token | Get access token |
E01 - Application Management
| POST | /applications | Create application |
| GET | /applications | List applications |
| GET | /applications/{id} | Get application details |
| POST | /applications/{id}/documents | Upload documents |
| GET | /applications/{id}/readiness | Check readiness |
| POST | /applications/{id}/submit | Submit application |
E03-E08 - Verification Services
| POST | /verify | Run verification |
| POST | /verify/gst | GST verification |
| POST | /verify/mca | MCA verification |
| POST | /verify/pan | PAN verification |
| POST | /verify/bank | Bank statement verification |
E09 - RRP Generation
| GET | /rrp/{request_id} | Get verification report |
| GET | /rrp/{request_id}/pdf | Download PDF report |
E15 - PSB Xchange Platform
| POST | /platform/{id}/banks | Enroll bank |
| GET | /platform/{id}/banks | List enrolled banks |
| PUT | /platform/{id}/config | Update platform config |
E16 - Invoice Screening
| POST | /screen/invoice | Screen invoice for duplicates |
| POST | /screen/batch | Batch invoice screening |
E17 - Fraud Consortium
| POST | /consortium/report-fraud | Report fraud |
| POST | /consortium/check | Check fraud status |
| GET | /consortium/alerts | Get fraud alerts |
E18 - SCF Products
| GET | /scf/products | List SCF products |
| GET | /scf/products/{id} | Get product details |
| POST | /scf/eligibility | Check eligibility |
E19 - Batch Operations
| POST | /verify/batch | Batch verification |
| GET | /verify/batch/{id} | Get batch status |
| GET | /verify/batch/{id}/results | Get batch results |
E20 - Analytics
| GET | /analytics/dashboard | Dashboard metrics |
| GET | /analytics/trends | Trend analysis |
| POST | /analytics/export | Export reports |
Response Codes
200 | Success |
201 | Created |
400 | Bad Request |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
422 | Validation Error |
500 | Internal Server Error |
Interactive Documentation