Skip to main content

Getting Started

Welcome to the Status Check API! This guide will help you get started with validating domains and emails in minutes.

What is Status Check?​

Status Check is an enterprise-grade domain and email validation API that helps you:

  • Verify domain validity - Check if domains are active and reachable
  • Validate email addresses - Ensure email addresses are deliverable
  • Score lead quality - Get automated quality scores (0-100) for your leads
  • Clean your data - Remove invalid domains and emails from your lists
  • Improve ROI - Focus on high-quality leads and improve conversion rates

Quick Start​

1. Create Your Account​

Sign up for a free account at app.status-check.io:

  1. Visit the dashboard
  2. Click "Sign Up" or "Get Started"
  3. Complete the registration form
  4. Verify your email address

2. Get Your API Key​

Once logged in:

  1. Navigate to your Profile page
  2. Click on the "API Keys" tab
  3. Click "Create New API Key"
  4. Give your key a descriptive name (e.g., "Production", "Development")
  5. Copy your API key immediately (it won't be shown again)
Keep Your API Key Secret

Never share your API key publicly or commit it to version control. Store it securely using environment variables.

3. Purchase Credits​

Status Check uses a simple credit system:

  • $1 = 1,000 validations
  • 0.001 credits per domain or email validation
  • No monthly fees - Pay only for what you use

To purchase credits:

  1. Go to the Credits page
  2. Enter the amount you want to spend
  3. Complete the payment via Stripe
  4. Credits are added to your account instantly

4. Make Your First API Call​

Here's a simple example to validate a domain:

curl -X POST https://api.status-check.io/v1/check \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"domain": "example.com"}'

Response:

{
  "domain": "example.com",
  "status": "valid",
  "http_status": 200,
  "ssl_valid": true,
  "response_time": 145,
  "score": 95,
  "timestamp": "2025-03-02T10:30:00Z"
}

Three Ways to Validate Leads​

Upload a CSV file with your lead data:

  1. Go to the Leads page
  2. Click "Upload CSV"
  3. Select your file (must include a domain or email column)
  4. Review the preview
  5. Click "Process File"

Status Check will automatically validate all domains/emails and update your leads with scores and validation results.

CSV Format Example:

first_name,last_name,email,domain,company
John,Doe,john@example.com,example.com,Example Corp
Jane,Smith,jane@acme.org,acme.org,Acme Inc

2. Single Lead Entry​

Add individual leads through the dashboard:

  1. Go to Leads page
  2. Click "Add Lead"
  3. Fill in the lead details
  4. Submit the form

The domain/email will be validated automatically.

3. API Integration​

Integrate validation directly into your application:

const response = await fetch('https://api.status-check.io/v1/check', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.STATUS_CHECK_API_KEY,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    domain: 'example.com'
  })
});

const result = await response.json();
console.log(`Domain score: ${result.score}`);

Understanding Validation Results​

Validation Status​

  • valid - Domain is active and reachable
  • invalid - Domain does not exist or is unreachable
  • unknown - Unable to determine status (temporary issues)

Lead Score (0-100)​

The lead score represents overall quality:

  • 90-100: Excellent - Active domain with valid SSL, fast response
  • 70-89: Good - Valid domain, may have minor issues
  • 50-69: Fair - Valid but with some concerns
  • Below 50: Poor - Significant issues detected

Scoring Factors:

  • Domain accessibility (HTTP/HTTPS)
  • SSL certificate validity
  • Response time
  • DNS configuration
  • Domain reputation signals

Best Practices​

1. Secure Your API Keys​

# Store in environment variables
export STATUS_CHECK_API_KEY="sk_your_api_key"
// Use environment variables in code
const apiKey = process.env.STATUS_CHECK_API_KEY;

2. Handle Rate Limits​

  • 60 requests per minute
  • 1,000 requests per hour

For bulk operations, use the batch endpoint or CSV upload instead of individual requests.

3. Error Handling​

Always implement proper error handling:

try {
  const response = await fetch('https://api.status-check.io/v1/check', {
    method: 'POST',
    headers: {
      'X-API-Key': apiKey,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ domain: 'example.com' })
  });

  if (!response.ok) {
    throw new Error(`API error: ${response.status}`);
  }

  const result = await response.json();
  console.log(result);
} catch (error) {
  console.error('Validation failed:', error);
}

4. Monitor Your Credits​

Keep track of your credit balance to avoid service interruptions:

curl -X GET https://api.status-check.io/v1/credits \
  -H "X-API-Key: sk_your_api_key"

Common Use Cases​

Marketing Teams​

Clean your lead lists before campaigns to improve deliverability and ROI.

Sales Teams​

Prioritize high-scoring leads to focus on the most promising prospects.

SaaS Platforms​

Validate user emails during signup to reduce fraud and improve user quality.

Agencies​

Deliver better results for clients by providing validated, high-quality leads.

Next Steps​

Need Help?​

Ready to start validating? Create your account and get your first 100 validations free!