Quick Start Guide

Get up and running with InboxRisk API in just 5 minutes. Choose your preferred language and follow along.

Get Your API Key

Create a free account to access the API

1.Go to Sign Up and create your account
2.Verify your email address
3.Navigate to Dashboard → API Keys
4.Click "Generate New Key" and copy your API key

⚠️ Keep it secret: Never share or commit your API key to version control. Treat it like a password.

Install the SDK

Choose your programming language

Node.js / JavaScript

npm install inboxrisk

Or with yarn: yarn add inboxrisk

Python

pip install inboxrisk

PHP

composer require inboxrisk/sdk

go get github.com/inboxrisk/go-sdk

Make Your First API Call

Check email risk with sample code

Node.js

const InboxRisk = require('inboxrisk');

const client = new InboxRisk('your_api_key');

async function checkEmail() {
  const result = await client.email.riskCheck({
    email: 'test@example.com'
  });

  console.log('Risk Score:', result.risk_score);
  console.log('Is Disposable:', result.is_disposable);
  console.log('Risk Level:', result.risk_level);
}

checkEmail();

Python

from inboxrisk import InboxRisk

client = InboxRisk('your_api_key')

result = client.email.risk_check(
    email='test@example.com'
)

print('Risk Score:', result['risk_score'])
print('Is Disposable:', result['is_disposable'])
print('Risk Level:', result['risk_level'])

PHP

<?php
require 'vendor/autoload.php';

$client = new InboxRisk\Client('your_api_key');

$result = $client->email()->riskCheck([
    'email' => 'test@example.com'
]);

echo 'Risk Score: ' . $result['risk_score'];
echo 'Is Disposable: ' . 
  ($result['is_disposable'] ? 'Yes' : 'No');
echo 'Risk Level: ' . $result['risk_level'];

cURL

curl -X POST https://api.inboxrisk.com/v1/email/risk-check \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "test@example.com"
  }'

✓ Success: You should receive a response with the email risk analysis. Check the risk_score field!

Understanding the Response

{
  "email": "test@example.com",
  "risk_score": 45,
  "risk_level": "medium",
  "is_disposable": false,
  "is_valid_format": true,
  "is_smtp_valid": true,
  "fraud_reports": 0,
  "fraud_indicators": [],
  "domain_risk": {
    "age_days": 2150,
    "reputation_score": 92,
    "is_blacklisted": false
  },
  "created_at": "2026-07-07T10:30:00Z"
}

risk_score0-100

Overall risk score. Higher = riskier. 0-25 is safe, 25-50 is medium, 50-75 is high, 75+ is critical.

risk_levelsafe / medium / high / critical

Categorical risk assessment based on the risk score.

is_disposabletrue / false

Whether the email is from a temporary/disposable email service.

fraud_reportsnumber

Number of community fraud reports for this email address.

Common Use Cases

🔐 Signup Protection

Block disposable emails and high-risk addresses during user registration to prevent fake accounts.

See Implementation →

📧 List Cleaning

Use bulk API to verify your existing email list and remove invalid or risky addresses.

Learn More →

🎯 Payment Fraud Prevention

Check email risk during checkout to reduce chargeback and fraud risk on transactions.

Use Case Guide →

📊 Data Compliance

Maintain list hygiene and meet GDPR compliance by verifying email addresses regularly.

Best Practices →

Next Steps

📚 API Endpoint Reference

Complete documentation of all available API endpoints with request/response examples.

⚙️ SDK Documentation

Detailed guides for Node.js, Python, PHP, and Go SDKs with advanced features.

🚀 Integration Guides

Step-by-step guides for integrating InboxRisk into popular frameworks and platforms.

Need Help?

Our support team is here to help. Check the FAQ, read the docs, or reach out directly.

Documentation