Skip to content
ValidationCheck

Test mode

Requests with a vc_test_ key never call a data provider and never use credits. Use the inputs below to get each documented outcome; any other input gets a plausible synthetic answer. Every test response has "test_mode": true in metadata.

Email

Section titled “Email”
Input Result
valid@test.validationcheck.net valid, mailbox exists
invalid@test.validationcheck.net invalid, mailbox not found
catchall@test.validationcheck.net risky, catch-all domain
disposable@mailinator.com risky, disposable address

Phone

Section titled “Phone”
Input Result
+1 555 010 0001 Valid mobile
+1 555 010 0002 Valid landline
+1 555 010 0003 Valid VoIP
+1 555 010 0004 Invalid

IP

Section titled “IP”
Input Result
203.0.113.10 Residential, clean
203.0.113.66 VPN
203.0.113.99 Tor exit node

Domain

Section titled “Domain”
Input Result
new-domain.example Registered 3 days ago
unregistered.example Not registered
weak-auth.example Email DNS auth grade F

Forcing errors

Section titled “Forcing errors”

Add X-Test-Force-Error with any error code to get that error back, so you can test your handling:

Terminal window
curl https://api.validationcheck.net/v1/email \
  -H "Authorization: Bearer $VC_TEST_KEY" \
  -H "X-Test-Force-Error: RATE_LIMITED" \
  -H "Content-Type: application/json" \
  -d '{"email": "valid@test.validationcheck.net"}'
# → 429 with Retry-After: 1