Quick Start

Overview

DeliverIQ is a comprehensive email verification and intelligence platform. Verify single emails, process bulk lists, find business emails, and analyze domain infrastructure — all through a unified REST API.

Base URL: https://api.deliveriq.com/v1 — all endpoints in this documentation are relative to this base.

Free tier: Every new account receives 100 credits per month. Single verification costs 1 credit, email finder costs 2 credits, and domain tools cost 1 credit each. Credits reset on the 1st of each month.

Sandbox test emails: 28 deterministic test addresses at @deliveriq.com return fixed results with 0 credits. Try test-safe@deliveriq.com (score 95, safe) or test-invalid-syntax@deliveriq.com (score 0, syntax error). See the Sandbox & Testing guide for the full list.

This guide walks you through your first API call in under 5 minutes.

Get Your API Key

Navigate to the Account page to create an API key. Your key is shown once at creation — store it securely.

⚠ Never expose your API key in client-side code or public repositories.

Go to Account

Navigate to DeliverIQ > Account > API Keys.

Create a Key

Click "Create API Key", give it a name (e.g., "Production"), and copy the full key.

Store Securely

The full key is only shown once. Store it in your environment variables or secrets manager.

Your First Verification

Verify a single email address with one API call. The response includes the full 20-check result with confidence scoring.

curl -X POST https://api.deliveriq.com/v1/verify \
  -H "MiN8T-Api-Auth: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "test-safe@deliveriq.com"}'

Response200

{
  "success": true,
  "result": {
    "email": "test-safe@deliveriq.com",
    "reachability": "safe",
    "score": 95,
    "syntax": { "valid": true, "localPart": "test-safe", "domain": "deliveriq.com" },
    "mx": { "valid": true, "records": [{ "exchange": "mail.deliveriq.com", "priority": 10 }] },
    "smtp": { "canConnect": true, "isDeliverable": true, "isCatchAll": false },
    "misc": { "isDisposable": false, "isRoleBased": false, "isFreeProvider": false },
    "intelligence": { "spamTrapScore": 0.02, "domainAge": { "ageDays": 4017, "riskLevel": "normal" } },
    "verifiedAt": "2026-03-03T10:00:00Z",
    "durationMs": 1250,
    "sandbox": true
  },
  "creditsUsed": 0
}

Full verification result with 20-check breakdown. Sandbox emails return creditsUsed: 0.

SDK Quickstart (Recommended)

The official SDKs handle authentication, retries, and error handling automatically. Copy one of these complete, runnable scripts:

ℹ Install the SDK for your language: npm install @deliveriq/sdk (Node.js), pip install deliveriq (Python), composer require deliveriq/sdk (PHP), go get github.com/deliveriq/deliveriq-go (Go), or gem install deliveriq (Ruby). See the SDKs & Libraries guide for all features.

# Verify an email — replace YOUR_API_KEY with your actual key
curl -X POST https://api.deliveriq.com/v1/verify \
  -H "MiN8T-Api-Auth: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "test-safe@deliveriq.com"}'

Interpreting Results

Every verification returns a reachability classification and a deliverability score between 0 and 100.

Reachability	Score Range	Action
safe	80 – 100	Safe to send — high confidence the mailbox exists and accepts mail.
risky	40 – 79	Proceed with caution — catch-all domains, role accounts, or limited verification.
invalid	0 – 39	Do not send — invalid syntax, non-existent domain, or rejected by SMTP.
unknown	N/A	Could not determine — SMTP timeout, greylisting, or temporary failure. Retry later.

Next Steps

Now that you've verified your first email, explore the full capabilities:

SDKs & Libraries — Use official SDKs (Node.js, Python, PHP, Go, Ruby) for automatic retries, typed errors, and idiomatic API access.

Batch Processing — Upload CSV files or send arrays of up to 10,000 emails for async processing.

Email Finder — Find verified business emails by name and company domain.

Domain Intelligence — Analyze blacklists, SPF/DKIM/DMARC, spam traps, and domain trust scores.

ESP Integrations — Import lists directly from Mailchimp, Brevo, and 80+ other providers.

DMARC Monitoring — Monitor email authentication compliance, track sending sources, and set up alerts for your domains.