How it works
AIM products
Official Freddie Mac resource: Asset and Income Modeler (AIM)Income and employment (AIM)
Automated income and employment assessment through payroll data. LPA evaluates borrower income using Truv’s VOIE report data.Assets (AIM)
Automated asset assessment from connected bank accounts. LPA evaluates account balances, ownership, and transaction history.Document income (AIM Check API)
For borrowers without a direct payroll connection, Truv supports the AIM Check API for instant paystub and W-2 assessment. Upload documents through Document Processing and submit the report to LPA.“Current as of” date: For LPA, this reflects the pay date of the borrower’s last pay statement.
Implementation checklist
Use this sequence for a production-ready Freddie Mac flow:- Complete your Truv integration using LOS integrations or Custom Integration
- Collect VOIE, VOA, or AIM Check document income based on the borrower workflow
- Retrieve the latest report identifier for the product you will submit
- Submit the current Report ID through Loan Product Advisor
- Review AIM feedback and confirm the result matches the loan scenario
- If Truv data is refreshed, resubmit using the newest Report ID
Integrate with Encompass
For ICE Encompass clients, Truv’s Report ID appears in the Loan: GSE Additional Provider Data screen under the Freddie Mac section.VOA field mapping
| Borrower | Coborrower |
|---|---|
GSEVENDOR.X43 | GSEVENDOR.X44 |
VOIE field mapping
Write the Report ID to the appropriate Encompass Freddie Mac vendor field for your implementation.Validation checklist
Verify the correct product path
Confirm whether the loan is using payroll-based AIM, asset-based AIM, or document-based AIM Check before retrieving the final report.
Confirm report freshness
Always use the latest Truv report generated for the borrower. Refreshed data creates a new Report ID and should replace older IDs in LPA submission.
Check Encompass mapping
If you use Encompass, confirm the Freddie Mac Report ID fields are populated correctly before the loan is submitted.
Reference test data
Use shared sandbox credentials from Test Credentials and Test Credentials for end-to-end borrower login testing. Use the Freddie Mac-specific report IDs below when you need AIM-oriented reference data and sample PDFs.Income & employment report IDs
| Report ID | SSN | Borrower | Sample Report |
|---|---|---|---|
5abf3fddc6cd44a38038c0c6bfd4f26f | 990-50-0005 | Patrick Freddie | |
bf23a64ceaf74988b14570a549d0b1c8 | 990-40-0004 | Amy Freddie | |
57868adf572f46fb989adf16a30c1ebd | 990-70-0007 | Suzi Freddie | |
1a531ae648254ec3a27c4e259ab507f3 | 990-11-0011 | Mom Freddie | |
776f4e58b115428f94776c884c073d4d | 990-08-0008 | Alice Freddie | |
729851aad6404bf9b30248a11445fec5 | 990-30-0003 | Andy Freddie |
Assets report IDs
| Report ID | SSN | Borrower | Sample Report |
|---|---|---|---|
b8aa127afb1246428f0c8868c863080b | 990-80-0008 | Alice Freddie | |
4f6bfd8bdc6645f199408fd2a35213c4 | 991-10-0011 | Mom Freddie | |
cb893b4564f949bcb20eca3b05c547af | 991-00-0010 | Dad Freddie | |
415d91bd02a64954a15f254a8b1bb5b5 | 990-20-0002 | Mary Freddie | |
668a2ff8101f420e94f0b04c5ada6337 | 990-10-0001 | John Freddie | |
36d0a637117041c098ee39b8d8f364f1 | 990-70-0007 | Suzi Freddie |
Test in sandbox
For shared sandbox setup and reusable credentials, see Test Credentials and Test Credentials. For the mortgage-specific validation flow, see GSE testing.Next steps
Day 1 Certainty (D1C)
Fannie Mae Desktop Underwriter integration
AIM Check
Document-based Freddie Mac income workflow
Sample Reports
Shared report retrieval patterns and Encompass mappings
Launch Checklist
Pre-production mortgage validation