API v1

Security API Documentation

Comprehensive API documentation for email and IP address security checks. Built for developers who prioritize security and reliability.

API Endpoint
Base URL for all API requests
POSThttps://api.securekit.dev/api/v1/check
Authentication
All requests require an API key in the request body

Include your API key in the request payload:

"api_key": "your_api_key_here"
Email Validation
Validate email addresses, check DNS records, SPF, DMARC, and more security features

Request Payload

Request Body
{
  "query": "example@example.com",
  "api_key": "your_api_key_here"
}

Response Example

Response Body
{
  "email": "example@example.com",
  "domain": "example.com",
  "valid": true,
  "disposable": false,
  "dns_valid": true,
  "spf_record": true,
  "dmarc_record": true,
  "domain_age": null,
  "domain_created": null,
  "a_records": [
    "93.184.216.34"
  ],
  "mx_records": [
    "10 mail.example.com."
  ],
  "risk_score": 10
}

Code Examples

JavaScript
const axios = require('axios');

async function checkEmail() {
  try {
    const response = await axios.post('https://api.securekit.dev/api/v1/check', {
      query: 'example@example.com',
      api_key: 'your_api_key_here'
    });
    
    console.log(response.data);
  } catch (error) {
    console.error('Error:', error.response?.data || error.message);
  }
}

checkEmail();
Email Response Fields
Understanding the email validation response structure
emailThe email address checked
validEmail format validity (boolean)
disposableIf email is from disposable domain
dns_validDNS record validation status
spf_recordSPF record presence (boolean)
dmarc_recordDMARC record presence (boolean)
risk_scoreRisk assessment score (0-100)
IP Response Fields
Understanding the IP address check response structure
is_blacklistedBlacklist status (boolean)
is_vpn_or_proxyVPN/Proxy detection (boolean)
risk_scoreRisk assessment score (0-100)
country, region, cityGeolocation data (strings)
isp, orgISP and organization information
lat, lonGeographic coordinates (floats)