Skip to content

Sandbox

Sandbox makes testing simple and effective by providing access to mocked persons. This guide will help you understand Sandbox's core features, its functionality, and how to use it to simulate real-world scenarios during integration.

What is Sandbox?

Think of Sandbox as a virtual playground for your available integrations, where real-world persons are replaced with mocked persons you can control instantly.

Key features

  • Supports all markets: We provide a set of predefined mocked persons in all markets, but you are free to create your own.
  • Full state control: Modify persons states instantly to simulate real-world conditions.
  • Third-party integration: For some third-party integrations, we also have an integration to their test environment.

Limitations

We currently have limited support for third-party integrations in Sandbox. See the Sandbox-column of the Sources table.

Available data

The sandbox environment contains mocked, but realistic data, for testing purposes. The environment is suitable for testing most of Consumer Intelligence's functionality, but some functionality in the production environment may not be available in Sandbox.

These are the mocked persons in Sandbox, including persons that changes even/uneven days:

Getting started

Creating mocked persons

Use the Create or update sandbox person endpoint to create or update a mocked person in Sandbox. The mocked person will be made available for your client only when interacting with Consumer Intelligence. This includes all use cases of retrieving person data, such as the Find API, the Get API, and when uploading new consumers.

Trigger life events

  1. Ensure you have created a mocked person.
  2. Ensure you have created a webhook, and the webhook is configured to listen to LIFE_EVENT events.
  3. Use the id of the mocked person to send an API request to the Trigger life event endpoint.

Limitations

Consumer Intelligence aggregates dozens of sources in different formats into a single common schema; this means that the coverage of data for different sources may vary in production, either due to missing data in the source, or lack of authoritative rights to access the data. See the Sandbox-column of the Sources table for a more detailed description of the availability of data.