Skip to main content
Use this page as a narrow reference for report retrieval patterns and Encompass field mappings after your GSE workflow is already set up. Truv’s vendor ID is Truv.

​
VOIE Reports

VOIE reports are generated from employment and income data after the borrower completes the verification process.
DU (Desktop Underwriter): The “Current as of” date reflects the end of period from the borrower’s last pay statement.LPA (Loan Product Advisor): The “Current as of” date reflects the pay date of the borrower’s last pay statement.

​
Retrieve VOIE Report

1

Get the Report ID

  • Bridge Token implementations: Call users/{user_id}/reports/ to retrieve the report_id
  • Order implementations: Call orders/{id}/ to retrieve the voie_report_id
Ensure the borrower has completed verifications of all requested employments before retrieving the Report ID, otherwise you may receive only partial DU or AIM validation.
2

Download the Report

Call users/{user_id}/reports/{report_id}/?fmt=pdf for PDF format. Use fmt=json for the JSON response.

​
VOIE Encompass Field Mapping

Write the Report ID to Encompass FieldID GSEVENDOR.X50. For borrower and coborrower, comma-separate the Report IDs: 
borrower_report_id,coborrower_report_id

​
VOA Reports

VOA reports are generated when a borrower completes Verification of Assets. Refreshing the data generates a new report and a new Report ID. Always supply Fannie Mae and Freddie Mac with the most recent Report ID.

​
Retrieve VOA Report

1

Get the Report ID

  • Bridge Token implementations: Call users/{user_id}/assets/reports/ to retrieve the report_id
  • Order implementations: Call orders/{id}/ to retrieve the voa_report_id
Ensure the borrower has completed verifications of all requested asset accounts before retrieving the Report ID, otherwise you may receive only partial DU or AIM validation.
2

Download the Report

Call users/{user_id}/assets/reports/{report_id}/?fmt=pdf for PDF format. Use fmt=json for the JSON response.

​
VOA Encompass Field Mapping

GSEBorrower FieldCoborrower Field
Fannie Mae DU (D1C)GSEVENDOR.X37GSEVENDOR.X38
Freddie Mac AIMGSEVENDOR.X43GSEVENDOR.X44

​
Next steps

GSE Testing

Workflow, validation checklist, and test scenarios

Fannie Mae D1C

Day 1 Certainty integration

Freddie Mac AIM

Loan Product Advisor integration

Sandbox

Sandbox credentials and test scenarios