Skip to main content
Set "testMode": true on any screening request (search, company or person) to run it against the test environment instead of the live lists. Use it while developing and testing your integration.

​
What changes in test mode

  • The response has exactly the same shape as a live screening, with testMode set to true.
  • The order is placed with price 0 and its title is prefixed with [TEST], so test screenings are visible in your order history but never billed.
  • Hits come from the test environment’s data, not from the real lists. A person who is sanctioned in reality may return no hits in test mode, and test subjects may return hits that do not exist in reality.
  • A test screening is never reused for a live call, and a live screening is never returned to a test call.
  • Test screenings are stored like live ones, but only compared with other test screenings: a test hit never marks a live hit as seen, and decisions on test hits never carry into live screenings.
Everything else, including authentication, validation, feature tier and rate limits, works the same way in both modes.
Contact support for the test subjects that are known to produce hits in the test environment.
testMode defaults to false. Make sure it is not left enabled in production code: a test screening returns test data and does not screen the live lists.