Sandbox Mode

Use sandbox mode to test your integration without creating real verifications or incurring charges.

Test API Keys

Sandbox mode is activated by using a test API key (prefixed with tv_test_) instead of a live key.

Getting a Test Key

  1. Go to Settings
  2. Create a new API key and select "Test" as the environment
  3. Use the tv_test_ prefixed key in your requests

Test Email Addresses

Use these special email addresses in sandbox mode to simulate different verification outcomes:

EmailOutcomeDescription
success@test.tenantverify.orgcompletedSimulates a successful verification with $6,500/month income
fail@test.tenantverify.orgfailedSimulates a failed bank connection
expired@test.tenantverify.orgexpiredSimulates an expired verification link
lowincome@test.tenantverify.orgcompletedSimulates verification with $1,800/month income (fails 3x rule at $2,000 rent)

Example Sandbox Request

curl -X POST https://tenantverify.org/api/v1/verify \
  -H "Authorization: Bearer tv_test_your_test_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "tenant_email": "success@test.tenantverify.org",
    "tenant_name": "Test Tenant",
    "monthly_rent": 2000
  }'

Sandbox Limitations

  • No emails are sent to tenants in sandbox mode
  • Verifications complete instantly (no waiting for tenant action)
  • Webhooks are still sent to your configured URL
  • Sandbox verifications do not count toward your plan limits
  • Test data is automatically cleaned up after 24 hours
← Rate LimitsBack to Overview →