> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truv.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Report Sizes

> Typical and long-tail payload sizes for Truv reports, so you can plan storage, request timeouts, and bandwidth.

Use this page to size storage, request timeouts, and ingestion buffers for Truv report endpoints.

<Note>
  PDFs are predictable and bounded. JSON payloads — especially for assets and AIM — tail to **multiple megabytes** at the long tail. Size your reads accordingly.
</Note>

***

## 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.

<AccordionGroup>
  <Accordion title="Verification of Income (VOIE) Report">
    Returned by [VOIE report retrieve](/api-reference/user-income-and-employment-reports/users_get_report).

    | Format | p50     | p90      | p95      | p99     | max     |
    | :----- | :------ | :------- | :------- | :------ | :------ |
    | pdf    | 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  |
  </Accordion>

  <Accordion title="Verification of Assets (VOA) Report">
    Returned by [Assets report retrieve](/api-reference/user-asset-verification-reports/assets-report-retrieve).

    | Format | p50      | p90      | p95      | p99      | max      |
    | :----- | :------- | :------- | :------- | :------- | :------- |
    | pdf    | 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   |
  </Accordion>

  <Accordion title="Freddie AIM Check">
    Returned by [Assets report retrieve](/api-reference/user-asset-verification-reports/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         |
    | :------- | :------- | :------ | :------ | :--------- | :---------- |
    | pdf      | 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** |
  </Accordion>

  <Accordion title="Freddie Mac VOA Submission">
    Returned by [Assets report retrieve](/api-reference/user-asset-verification-reports/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 |
  </Accordion>

  <Accordion title="Fannie Mae Day 1 Certainty Submission">
    Returned by [Assets report retrieve](/api-reference/user-asset-verification-reports/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 |
  </Accordion>

  <Accordion title="Income Insights Report">
    Returned by [Income Insights retrieve](/api-reference/income-insights/income-insights-report-retrieve). Single-link income summary.

    | Format | p50     | p90     | p95     | p99     | max     |
    | :----- | :------ | :------ | :------ | :------ | :------ |
    | pdf    | 24.9 KB | 34.3 KB | 34.4 KB | 39.5 KB | 42.8 KB |
  </Accordion>

  <Accordion title="Deposit-based VOE (DVOE) Report">
    Returned by [Assets report retrieve](/api-reference/user-asset-verification-reports/assets-report-retrieve). Verifies employment from deposit patterns when a direct payroll connection isn't available.

    | Format | p50     | p90      | p95      | p99      | max     |
    | :----- | :------ | :------- | :------- | :------- | :------ |
    | pdf    | 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  |
  </Accordion>
</AccordionGroup>

***

## Planning guidance

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

***

## Next steps

<CardGroup cols={2}>
  <Card title="Sample reports" icon="file-lines" href="/mortgage/testing/sample-reports">
    Retrieval patterns and Encompass field mappings
  </Card>

  <Card title="Webhooks" icon="bell" href="/api-reference/webhooks">
    Get notified when a report is ready instead of polling
  </Card>

  <Card title="Data processing" icon="database" href="/api-reference/data-processing">
    How Truv assembles report data
  </Card>

  <Card title="Building with AI" icon="robot" href="/developers/building-with-ai">
    Connect the Truv MCP server to your AI tooling
  </Card>
</CardGroup>