Use this page to size storage, request timeouts, and ingestion buffers for Truv report endpoints.Documentation Index
Fetch the complete documentation index at: https://truv.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
PDFs are predictable and bounded. JSON payloads — especially for assets and AIM — tail to multiple megabytes at the long tail. Size your reads accordingly.
Sizes by report
Tap a report to see size distributions for each format it returns. Use the max and p99 columns to drive buffer and timeout sizing for the formats you fetch.Verification of Income (VOIE) Report
Verification of Income (VOIE) Report
Returned by VOIE report retrieve.
| Format | p50 | p90 | p95 | p99 | max |
|---|---|---|---|---|---|
| 17.2 KB | 19.5 KB | 21.9 KB | 26.3 KB | 40.3 KB | |
| json | 46.7 KB | 661.9 KB | 801.7 KB | 1.2 MB | 1.3 MB |
Verification of Assets (VOA) Report
Verification of Assets (VOA) Report
Returned by Assets report retrieve.
| Format | p50 | p90 | p95 | p99 | max |
|---|---|---|---|---|---|
| 39.4 KB | 87.4 KB | 167.9 KB | 298.4 KB | 306.8 KB | |
| json | 131.6 KB | 599.3 KB | 1.4 MB | 2.9 MB | 3.4 MB |
Freddie AIM Check
Freddie AIM Check
Returned by Assets report retrieve. The raw JSON variant carries account-level detail and is the largest format Truv produces — start your buffer and timeout sizing here.
| Format | p50 | p90 | p95 | p99 | max |
|---|---|---|---|---|---|
| 24.2 KB | 24.5 KB | 24.6 KB | 24.7 KB | 24.7 KB | |
| json | 33.9 KB | 34.8 KB | 34.9 KB | 35.4 KB | 35.4 KB |
| raw json | 463.5 KB | 2.4 MB | 4.1 MB | 9.9 MB | 10.9 MB |
Freddie Mac VOA Submission
Freddie Mac VOA Submission
Returned by Assets report retrieve. Multi-megabyte even at the median.
| Format | p50 | p90 | p95 | p99 | max |
|---|---|---|---|---|---|
| json | 784.7 KB | 2.7 MB | 3.5 MB | 6.1 MB | 6.4 MB |
Fannie Mae Day 1 Certainty Submission
Fannie Mae Day 1 Certainty Submission
Returned by Assets report retrieve. Typical payload is small, but the long tail reaches >1 MB on borrowers with deep transaction history.
| Format | p50 | p90 | p95 | p99 | max |
|---|---|---|---|---|---|
| json | 3.0 KB | 5.5 KB | 9.0 KB | 512.8 KB | 1.6 MB |
Income Insights Report
Income Insights Report
Returned by Income Insights retrieve. Single-link income summary.
| Format | p50 | p90 | p95 | p99 | max |
|---|---|---|---|---|---|
| 24.9 KB | 34.3 KB | 34.4 KB | 39.5 KB | 42.8 KB |
Deposit-based VOE (DVOE) Report
Deposit-based VOE (DVOE) Report
Returned by Assets report retrieve. Verifies employment from deposit patterns when a direct payroll connection isn’t available.
| Format | p50 | p90 | p95 | p99 | max |
|---|---|---|---|---|---|
| 20.0 KB | 32.0 KB | 36.3 KB | 45.8 KB | 77.3 KB | |
| json | 62.7 KB | 213.8 KB | 267.2 KB | 722.3 KB | 1.8 MB |
Planning guidance
HTTP client timeouts and buffers
HTTP client timeouts and buffers
Buffers. Most clients default to a 1 MB or 5 MB response buffer. The JSON payloads for Freddie AIM Check (raw), Freddie Mac VOA Submission, and the VOA Report regularly exceed those at p95+. Set client read buffers to at least 16 MB for the AIM raw JSON and 8 MB for the VOA and Freddie VOA JSON to avoid truncation under the long tail.Timeouts. Default HTTP client timeouts of 10–15 seconds can truncate raw-JSON downloads on slower connections. For the multi-megabyte JSON payloads above, set a request timeout of at least 60 seconds (longer if your client runs from a constrained network). PDFs and the smaller JSON variants are well-served by default timeouts.
Storage estimation
Storage estimation
For capacity planning, multiply your monthly report volume by the per-report average. The four heaviest payloads: Freddie Mac VOA Submission JSON ~1.2 MB, Freddie AIM Check raw JSON ~1.1 MB, VOA Report JSON ~306 KB, VOIE Report JSON ~192 KB. Every other format averages under 60 KB.Across all formats the cross-cutting average is ~255 KB per report. A workflow that pulls VOIE JSON + VOIE PDF + AIM raw JSON + Freddie VOA JSON averages ~2.5 MB per completed verification.
When to download lazily
When to download lazily
The Freddie AIM Check raw JSON has a >1 MB average and a 10.9 MB max. If you only need the AIM check decision and not the raw account-level detail, download the standard JSON variant of the AIM Check instead — it is ~30× smaller and bounded around 35 KB.
PDF vs JSON tradeoff
PDF vs JSON tradeoff
PDFs are uniformly small and predictable (typically under 100 KB). JSON formats carry transaction-level data, which scales with
days_requested and account count. If you only need a human-readable artifact, request the PDF format to avoid the JSON tail.Next steps
Sample reports
Retrieval patterns and Encompass field mappings
Webhooks
Get notified when a report is ready instead of polling
Data processing
How Truv assembles report data
Building with AI
Connect the Truv MCP server to your AI tooling