For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Truework.comAPI StatusGet your API key
HomeGuidesAPI referenceHelp
HomeGuidesAPI referenceHelp
    • Introduction
  • Using the API
    • Authentication
    • Versioning
    • Webhooks
    • Sandbox environment
      • Sandbox test cases
    • Monitoring
    • Limits
  • Verification orders & reports
    • POSTCreate a target employer order
    • POSTCreate an employer search order
    • POSTCreate a Truework Direct order
    • GETGet one order
    • GETGet all orders
    • PUTCancel an order
    • GETGet one report
    • GETGet order events
    • POSTReverify a report
  • Public beta APIs
  • Previous API versions
    • API version 2022-08-01
    • API version 2020-12-07
    • API version 2019-10-15
LogoLogo
Truework.comAPI StatusGet your API key
Using the APISandbox environment

Sandbox test cases

Was this page helpful?
Previous

Monitoring

Next
Built with

Truework provides a number of fixture references, to help develop and test customized loan application scenarios, specific to your business needs. While some fixture reference SSNs are Truework specific, we also support several SSNs that are also supported by Fannie Mae.

Test values in the Truework Sandbox are set with the targets[].social_security_number field. Test values will always fit within the Social Security Administration’s defined “Invalid” range.

A verification created in the sandbox that does not use a supported test SSN will return an HTTP 400 error, and will not be completed.

Terminal states

The terminal state column in the tables below indicates if a test SSN will return a report. If the terminal state is listed as completed a report will be returned. If the terminal state is canceled or action-required, a report will not be returned. For example, a verification request for (value 000-00-0004) will result in a completed response with a report for a Customer Service Representative.

Multiple reports

Verification requests may return multiple reports. For example, the Engineering Manager report (value 000-00-0007) contains multiple reports, and can be used to test parsing multiple reports.

Instant test cases

SSNTerminal stateTest applicant & titleStatusTypeStart dateEnd datePaystubsW2s
000-00-0000completedTaylor Curtis - Software EngineerActiveFull Time2019-01-01
000-00-0001completedSarah Cortez - Program ManagerInactiveFull Time2015-05-012022-01-01
000-00-0002completedJerome Fischer - AccountantOn LeavePart Time2017-02-03
000-00-0003completedKyle Baker - Product ManagerActiveFull Time2022-01-01
000-00-0004completedBrianna Hernandez - Customer Service RepresentativeActivePart Time2021-05-19
000-00-0005completedDiane Parker - Account ExecutiveInactiveFull Time2019-03-012020-12-28
000-00-0006completedOlivia Dunham - RecruiterInactiveFull Time2018-03-012021-03-10
000-00-0007completedAiden Henderson - Engineering Manager [1/2 Reports]ActiveFull Time2022-01-01
000-00-0007completedAiden Henderson - Engineering Manager [2/2 Reports]InactiveFull Time2018-03-012021-12-01
000-00-0008completedJohn Doe - Operations ManagerActiveFull Time2023-04-15
000-01-0000canceledN/AN/AN/AN/AN/AN/AN/A

Credentials test cases

While the below Credentials test cases in Sandbox will process instantly, borrower verifications processed via payroll login will not. Please plan accordingly when moving to Production.
SSNTerminal stateTest applicant & titleStatusTypeStart dateEnd datePermits successful login
000-20-0000completedTaylor Curtis - Software EngineerActiveFull Time03-16-2020
000-21-0000canceledN/AN/AN/AN/AN/AN/A

Smart Outreach test cases

SSNTerminal stateTest applicant & titleStatusTypeStart dateEnd datePaystubs
000-03-0000action-requiredN/AN/AN/AN/AN/AN/A
666-40-7416completedTaylor CurtisActiveFull Time01-01-2023

Fannie Mae test cases

SSNTerminal stateTest applicant & titleStatusTypeStart dateEnd dateD1C Reference ID
999-40-5000completedJohn HomeownerActiveFull Time03-16-2020
999-60-3333completedAndy AmericaActivePart Time01-03-2022
999-60-6666completedSuzi BuilderActiveFull Time01-03-2023
991-91-9991completedAlice FirstimerInactiveFull Time02-01-202302-02-2024
999-60-1111completedHomer LoanseekerActiveFull Time07-06-2015
999-00-1147completedJess T. SeaActiveFull Time07-06-2015
999-00-9066completedAnn T. SeaActiveFull Time07-06-2015