Skip to main content
Sandbox residents are mock identity records in the staging environment’s simulated ICP database. They allow you to test verification journeys without using real government data.

​
Overview

The Sandbox Residents module lets you:
  • Create test residents with specific identity details (Emirates ID, passport, biometrics)
  • Configure test scenarios such as expired visas, out-of-UAE status, or revoked documents
  • Edit resident data to test different validation outcomes
  • Upload selfies for face matching and journey approval testing
Sandbox residents are only available in the Staging environment. See Environments for details on the three platform environments.

​
Accessing Sandbox Residents

  1. Log into the Staging Dashboard
  2. Navigate to your client organization
  3. Click Sandbox Residents in the left sidebar
Sandbox Residents

​
Creating a Sandbox Resident

1
Open the creation form
2
Click the Add Resident button (or equivalent) in the top-right corner of the Sandbox Residents page.
3
Add Resident
4
Choose creation method
5
You can create a sandbox resident in two ways:
6

Auto-Assign

Automatically generates a resident with pre-filled mock data. Quick for basic testing, but some fields (such as activePassport) may show “UNKNOWN” placeholders.

Manual Entry

Manually enter all resident details including Emirates ID, passport information, and biometric data. Use this method when you need specific field values for targeted test scenarios.
7
Fill in resident details
8
For manual entry, provide the following information:
9
FieldDescriptionExampleEmirates ID15-digit ID starting with 784784-1234-1234567-1Full Name (English)Resident’s name in EnglishJohn SmithFull Name (Arabic)Resident’s name in ArabicArabic nameDate of BirthDate of birth1990-01-15NationalityCountry of nationalityGBRGenderMale / FemaleMalePassport NumberPassport document numberAB1234567Passport ExpiryPassport expiration date2030-12-31Visa StatusActive / Expired / CancelledActiveImmigration StatusCurrent immigration statusACTIVE
10
Upload a selfie (optional)
11
To test face matching during verification journeys, upload a selfie photo to the resident’s profile. This enables the backend face comparison step during journey processing.
12
Save the resident
13
Click Save or Create to add the resident to the sandbox database. The resident will immediately be available for verification journeys.

​
Testing Scenarios

Edit sandbox resident fields to simulate specific verification outcomes:
ScenarioHow to Configure
Successful verificationSet all fields to valid values, active visa, valid passport, upload matching selfie
Expired visaSet the visa expiry date to a past date
Out-of-UAE statusSet immigration status to indicate the resident is outside the UAE
Expired passportSet the passport expiry date to a past date
Document mismatchEnter passport details that don’t match the Emirates ID record
Face mismatchUpload a selfie that doesn’t match the document photo
Sandbox resident data is editable at any time. You can modify fields to test different scenarios without creating new residents.

​
Using Sandbox Residents in Journeys

Once a sandbox resident is created, use their Emirates ID or passport details when initiating test journeys:
  1. Call the Create Journey API with the sandbox resident’s details
  2. Initialize the SDK (Web, Android, or iOS) with the returned journey token
  3. Complete the verification flow using the sandbox resident’s document and selfie data
  4. Retrieve results via the Journey Details API or Customer Details API

​
Tips

  • Use manual entry (not auto-assign) when testing passport-related flows to avoid “UNKNOWN” placeholder values
  • Create multiple residents with different configurations to build a comprehensive test suite
  • Upload selfies to sandbox profiles to test the full face matching pipeline
  • Sandbox operations do not consume API credits