API Documentation

Complete API reference, integration guides, and code examples for InboxRisk email risk checking. Built for developers, with comprehensive docs and multiple SDK options.

Quick StartView All Endpoints

Getting Started

1

Get API Key

Sign up for a free account and generate your API key from the dashboard. No credit card required.

Create Account →
2

Install SDK

Install the SDK for your preferred language using npm, pip, composer, or go get.

npm install inboxrisk
3

Make Your First Call

Follow the quick start guide to make your first API call and check email risk.

View Quick Start →

Key Concepts

Authentication

All API requests require authentication using your API key. Include it in the Authorization header as a Bearer token.

Authorization: Bearer your_api_key_here

Risk Scoring

InboxRisk provides a comprehensive risk score (0-100) combining multiple signals: disposable status, fraud reports, domain reputation, and AI content analysis. Higher scores indicate higher risk.

Rate Limiting

API requests are rate-limited based on your plan. Check the X-RateLimit-* headers in responses to monitor your usage.

  • Free: 100 requests/month
  • Pro: 50,000 requests/month (burst to 1,000/second)
  • Enterprise: Unlimited with custom limits

Error Handling

The API returns standard HTTP status codes. Errors include a detailed error message and code for debugging.

  • 200: Success
  • 400: Bad Request (invalid parameters)
  • 401: Unauthorized (invalid API key)
  • 429: Too Many Requests (rate limit exceeded)
  • 500: Server Error (temporary issue)

Official SDKs

Node.js

JavaScript/TypeScript SDK for Node.js and browser environments

npm install inboxriskRead Docs →
Python

Python SDK for easy integration with Python applications

pip install inboxriskRead Docs →
PHP

PHP SDK with Composer support for Laravel and WordPress

composer require inboxriskRead Docs →
Go

Go SDK for high-performance server applications

go get github.com/inboxrisk/go-sdkRead Docs →
REST API

Direct REST API access without SDK for maximum flexibility

curl -X POST https://api.inboxrisk.com/v1/...Read Docs →
More Languages

SDKs for Ruby, Java, C#, and other languages coming soon

Documentation Resources

Security

Learn about our security practices, data encryption, compliance certifications, and responsible disclosure policy.

Security Policy →

Support

Get help from our support team. Email support for all plans, priority support for Enterprise customers.

Guides & Tutorials

Step-by-step guides for common use cases like preventing fake signups and detecting phishing emails.

Integration Guide →

Status & Uptime

Check our API status, uptime history, and scheduled maintenance notifications.

Frequently Asked Questions

Do I need a credit card to get started?▼

No, our free plan doesn't require a credit card. Start with 100 requests/month and upgrade anytime when you need more capacity.

What's the response time for API calls?▼

Our API responds in under 50ms on average. We maintain 99.9% uptime SLA for production deployments.

Can I use the API for bulk email verification?▼

Yes! Our bulk check endpoint supports up to 10,000 emails per request. Perfect for data migrations and list cleanup.

What payment methods do you accept?▼

We accept credit cards (Visa, Mastercard, American Express), wire transfers, and purchase orders for Enterprise customers.

Ready to integrate InboxRisk?

Start with the quick start guide or jump directly to the endpoint reference.

Quick StartAPI Reference