Using Test Emails

Test emails are special email addresses provided by SimpleCold that allow you to test your API integration without consuming credits. These emails return predictable validation results, making them perfect for development, testing, and integration verification.

What are Test Emails?

Test emails are predefined email addresses that return consistent validation results. When you validate a test email, the API returns a pre-configured response without performing actual email validation checks. This means:

• No Credits Consumed: Test emails do not count against your credit balance
• Instant Response: Results are returned immediately without network checks
• Predictable Results: Each test email always returns the same validation data
• Perfect for Testing: Ideal for development, integration testing, and API verification

Important: No Credit Consumption

important

Test emails do not consume any credits. You can use them as many times as you need for testing without affecting your credit balance.

Available Test Emails

The following test emails are available for use with all validation endpoints (single, batch, and bulk):

Email Address	Status	Status Message	Domain	MX Location	Site Location	Site Language	Fail Type
[email protected]	ok	Email is valid	example.com	US	US	US	none
[email protected]	ok	Email is valid	example.com	US	US	US	none
[email protected]	ok	Email is valid	example.com	US	US	US	none
[email protected]	ok	Email is valid	example.com	US	US	US	none
[email protected]	ok	Email is valid	example.com	US	US	US	none
[email protected]	ok	Email is valid	example.com	US	US	US	none

All test emails return a status of ok, indicating they are valid and deliverable email addresses.

Response Format

When you validate a test email, you'll receive a response in the same format as regular email validation:

Single Email Validation Response

{
  "status": "SUCCESS",
  "payload": {
    "email": "[email protected]",
    "domain": "example.com",
    "status": "ok",
    "statusMessage": "Email is valid",
    "mxLocation": "US",
    "siteLocation": "US",
    "siteLanguage": "US",
    "failType": "none"
  }
}

Batch Email Validation Response

{
  "status": "SUCCESS",
  "payload": [
    {
      "email": "[email protected]",
      "domain": "example.com",
      "status": "ok",
      "statusMessage": "Email is valid",
      "mxLocation": "US",
      "siteLocation": "US",
      "siteLanguage": "US",
      "failType": "none"
    },
    {
      "email": "[email protected]",
      "domain": "example.com",
      "status": "ok",
      "statusMessage": "Email is valid",
      "mxLocation": "US",
      "siteLocation": "US",
      "siteLanguage": "US",
      "failType": "none"
    }
  ]
}

Use Cases

Development and Testing

Use test emails during development to:

• Verify API Integration: Ensure your code correctly handles API responses
• Test Error Handling: Verify your application handles different response formats
• Development Workflow: Test without consuming credits during development
• CI/CD Pipelines: Include test emails in automated testing workflows

Integration Verification

Before going to production:

• Validate API Setup: Confirm your API key and authentication are working
• Test Response Parsing: Ensure your code correctly parses validation results
• Verify Endpoints: Test all validation endpoints (single, batch, bulk)
• Check Rate Limits: Understand rate limiting behavior without credit costs

Example Usage

Single Email Validation

const apiKey = "YOUR_API_KEY_HERE";
const testEmail = "[email protected]";

fetch(
  `https://api.simplecold.com/api/v1/api-validation/single?email=${encodeURIComponent(
    testEmail
  )}`,
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${apiKey}`,
      "Content-Type": "application/json",
    },
  }
)
  .then((response) => response.json())
  .then((data) => {
    if (data.status === "SUCCESS") {
      const result = data.payload;
      console.log(`Email: ${result.email}`);
      console.log(`Status: ${result.status}`); // Will always be "ok"
      console.log(`Message: ${result.statusMessage}`); // Will always be "Email is valid"
    }
  });

Batch Email Validation

const apiKey = "YOUR_API_KEY_HERE";
const testEmails = [
  "[email protected]",
  "[email protected]",
  "[email protected]",
];

fetch("https://api.simplecold.com/api/v1/api-validation/batch", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ emails: testEmails }),
})
  .then((response) => response.json())
  .then((data) => {
    if (data.status === "SUCCESS") {
      const results = data.payload;
      console.log(`Validated ${results.length} test emails`);
      // All will have status "ok"
    }
  });

Bulk Email Validation

You can include test emails in your CSV files for bulk validation:

email
[email protected]
[email protected]
[email protected]
[email protected]

Test emails in bulk validation files will also not consume credits.

Testing Your Integration

You can quickly test your integration using a test email:

curl -X GET "https://api.simplecold.com/api/v1/api-validation/[email protected]" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"

Expected response:

{
  "status": "SUCCESS",
  "payload": {
    "email": "[email protected]",
    "domain": "example.com",
    "status": "ok",
    "statusMessage": "Email is valid",
    "mxLocation": "US",
    "siteLocation": "US",
    "siteLanguage": "US",
    "failType": "none"
  }
}

Key Points to Remember

1. No Credit Cost: Test emails are completely free and don't consume credits
2. Consistent Results: Test emails always return the same validation data
3. All Endpoints: Test emails work with single, batch, and bulk validation endpoints
4. Case Insensitive: Test email matching is case-insensitive
5. Development Only: Test emails are designed for testing, not production use

Best Practices

• Use for Testing: Use test emails during development and testing phases
• Verify Integration: Test your API integration before using real email addresses
• Include in Tests: Add test emails to your automated test suites
• Document Usage: Document which test emails your team uses for consistency

Additional Resources

• Single Email Validation - Validate individual email addresses
• Batch Email Validation - Validate multiple emails at once
• Bulk Email Validation - Validate large email lists
• Using API Key - Learn about API authentication
• Create API Key - Generate your API key
• API Documentation - Overview of all API endpoints
• Contact Support - Get help with test emails