TIC
Sign in to Lens

Screening test mode

Run LENS API screenings against the test environment while developing - same request and response shape, free of charge, with test data instead of the live lists.

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.

{
  "testMode": true,
  "subjects": [
    { "reference": "test-1", "name": "Anna Exempelsson", "birthDate": "1975-04-12" }
  ]
}

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.

On the tic engine a test screening screens the live lists: free of charge and marked [TEST], but with real hits. It is still compared only with other test screenings.