Finviva Developer Platform (v1.0)
API Reference & Agent Integration
Build on Finviva’s double-entry ledger engine, trigger multimodal receipt OCR scans, and automate invoice collections via scoped OAuth 2.0 & REST APIs.
OpenAPI 3.1 Specification
Machine-readable schema with full RFC 9457 typed error responses and OAuth scopes.
llms.txt Manifest
Optimized knowledge summary and when-to-use guide for AI agents, Perplexity, and ChatGPT.
RFC 8414
OAuth 2.0 Auth Server
Standard metadata at /.well-known/oauth-authorization-server.
Quickstart: Trigger Multimodal Receipt OCR
https://finvivaapp.com/api/v1curl -X POST https://finvivaapp.com/api/v1/ocr/receipts \
-H "Authorization: Bearer YOUR_FINVIVA_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"fileUrl": "https://storage.example.com/receipts/aws_invoice.pdf",
"autoCategorize": true
}'// HTTP/2 200 OK
// RateLimit-Limit: 100
// RateLimit-Remaining: 99
{
"vendorName": "Amazon Web Services",
"subtotal": 480.00,
"salesTax": 32.40,
"totalAmount": 512.40,
"taxCategory": "Line 18 (Utilities / Cloud Tech Stack)",
"verified": true
}OAuth 2.0 Scopes & Permissions
| Scope | Permission Level | Description |
|---|---|---|
| accounting:read | Read | Query General Ledger, Trial Balance, P&L, and Balance Sheet. |
| accounting:write | Write | Post balanced double-entry journal transactions. |
| invoices:read | Read | Query customer invoices and collection aging status. |
| invoices:write | Write | Create invoices and trigger autonomous AR email chasers. |
| receipts:scan | Write | Submit receipt image/PDF for 1.2s multimodal OCR parsing. |