API Documentation

Complete guide to integrating CheckBoxHQ APIs into your application

Getting Started

To use the CheckBoxHQ API, you'll need an API key. Sign up for a free account and get your API key from the dashboard.

Base URL:

https://api.checkboxhq.com/v1

Authentication

All API requests require authentication using your API key in the request header: 

Authorization: Bearer YOUR_API_KEY

Disposable Email Detection

Check if an email address is from a disposable email provider.

Endpoint

POST /validate/disposable

Request Body

email

Response

email"user@example.com",
  "is_disposable": false,
  "provider": "example.com",
  "confidence": 0.99

MX Record Validation

Verify that a domain has valid mail exchange records.

Endpoint

POST /validate/mx

Request Body

domain

Response

A Record Verification

Check if a domain resolves to a valid IP address.

Endpoint

POST /validate/a-record

Request Body

domain

Response

domain

Public Email Provider Check

Identify if an email is from a free/public email provider.

Endpoint

POST /validate/public-provider

Request Body

email

Response

email
: "example.com", "has_a_record

Rate Limits

API rate limits depend on your plan:

  • Free Plan: 1,000 requests/month, 10 requests/minute
  • Starter Plan: 10,000 requests/month, 50 requests/minute
  • Pro Plan: 100,000 requests/month, 100 requests/minute
  • Enterprise Plan: Custom limits

Error Codes

Code Description
400 Bad Request - Invalid parameters
401 Unauthorized - Invalid API key
429 Too Many Requests - Rate limit exceeded
500 Internal Server Error