Sandbox Testing

Test your integration without affecting production data or using real credits.

Test Mode vs Live Mode

Feature	Test Mode	Live Mode
API Key Prefix	sk_test_	sk_live_
Real fraud checks	No	Yes
Credits consumed	No	Yes
Data persisted	7 days	Per plan
Webhooks	Sent to test endpoints	Sent to live endpoints

Using Test Mode

Simply use your test API key:

curl -X POST https://api.simplr-ai.com/v1/check \
  -H "X-API-Key: sk_test_xxxxxxxxxxxxx" \
  -d '{"email": "user@example.com"}'

Test Email Addresses

Use these special email addresses to trigger specific responses:

Email	Risk Score	Scenario
low@sandbox.simplr.test	5	Low risk
medium@sandbox.simplr.test	35	Medium risk
high@sandbox.simplr.test	65	High risk
critical@sandbox.simplr.test	90	Critical risk
disposable@tempmail.sandbox.simplr.test	85	Disposable email
velocity@sandbox.simplr.test	55	Velocity risk

Test Phone Numbers

Phone	Risk Score	Scenario
+15550000001	0	Low risk
+15550000003	35	Medium risk
+15550000004	68	High risk
+15550000005	95	Critical risk / recent swaps

Sandbox Endpoint

You can also use the explicit sandbox endpoint:

GET https://api.simplr-ai.com/v1/check/sandbox

This authenticated endpoint returns the complete current test-value catalogue and request examples. Use a test key with the normal POST /v1/check endpoint to receive the predictable result without consuming credits.

Example Sandbox Response

{
  "success": true,
  "message": "Sandbox test data",
  "content": {
    "description": "Use these test values in sandbox/test mode to get predictable responses",
    "phone_numbers": [],
    "emails": [],
    "event_types": {},
    "examples": {}
  }
}

Testing Webhooks

Test webhooks are sent to URLs configured in test mode:

1. Go to Dashboard > Webhooks
2. Make sure you're in Test Mode (toggle in top-right)
3. Add your test webhook URL
4. Trigger events using test API calls

Use Webhook Testing Tools

Tools like webhook.site or ngrok are great for testing webhooks locally.

Best Practices

1. Use test mode in development - Don't use production keys during development
2. Seed test data - Use the test email addresses to cover different scenarios
3. Test edge cases - Test both low and high risk scenarios
4. Verify webhook handling - Make sure your app handles all webhook events
5. Check error handling - Test how your app responds to API errors