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 are simple examples to validate a website or email:

Check Website:

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

Check Email:

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

Response (website):

{
  "website": "https://example.com",
  "httpStatus": 200,
  "sslValid": true,
  "redirectUrl": "https://www.example.com",
  "responseTime": 145,
  "timestamp": "2025-03-02T10:30:00Z"
}

Validation Methods​

Status Check offers three ways to validate your data:

1. Standalone Validation API​

Validate individual websites or emails directly without creating lead records:

  • Website validation: Check HTTP status, SSL, redirects, and response time
  • Email validation: Verify deliverability, MX records, and email provider
  • Use case: Quick validation, real-time form validation, one-off checks

See Validation API for detailed documentation.

2. Lead Management API​

Create and manage leads with automatic validation scoring:

  • Lead validation: Comprehensive scoring combining website and email checks
  • Bulk operations: Upload and validate multiple leads at once
  • Tracking: Store validation history and re-validate leads over time
  • Use case: CRM integration, lead list management, quality scoring

See Leads API for detailed documentation.

3. Dashboard Interface​

Manage leads and view validation results through the web interface:

  • CSV file upload for bulk lead imports
  • Manual lead entry and editing
  • Real-time validation status updates
  • Export validated results

Visit the dashboard to get started.

Understanding Lead Scores​

When you validate a lead (combining website and email checks), Status Check assigns a deliverability rating from 0-100:

Score RangeQualityWhat It Means
90-100ExcellentActive website with valid SSL, deliverable email, fast response
70-89GoodValid with minor issues (e.g., slow response, catch-all email)
50-69FairValid but concerns exist (e.g., redirect issues, disposable email)
Below 50PoorSignificant problems detected - avoid contacting

Key factors affecting scores:

  • Website HTTP status and SSL validity
  • Email deliverability and MX record configuration
  • Response times and redirect behavior
  • Domain age and reputation signals

See Lead Management for complete scoring details.

Best Practices​

Security​

Store API keys securely using environment variables - never commit them to version control:

export STATUS_CHECK_API_KEY="sk_your_api_key"

Rate Limits​

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

For bulk operations, use the bulk leads endpoint instead of individual requests.

Error Handling​

Always handle API errors gracefully:

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

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

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

Credit Monitoring​

Check your balance before large validation jobs:

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

See Credits API for complete documentation.

Common Use Cases​

  • Lead scoring: Automatically score and prioritize leads based on validation quality
  • Form validation: Verify emails and domains in real-time during user signup
  • List cleaning: Remove invalid contacts before marketing campaigns
  • CRM enrichment: Add validation data to existing contact records
  • Quality control: Monitor and maintain high-quality lead databases

Next Steps​

Support​