Product GuideAPI Reference

Product Guide

Everything you need to go from a messy contact list to a clean, send-ready one. Building an integration instead? Jump to the API reference.

Getting started

Create an account and you land in the dashboard with 1,000 free credits, no card required. The sidebar is the whole product: Verify Email for one-off checks, Bulk Lists for cleaning whole files, Deliverability for domain audits, History for your activity and credit ledger, and API for programmatic access.

Verify one email

Open Verify Email, type an address and hit verify. InboxValid has a live SMTP conversation with the receiving mail server, so the answer reflects whether the mailbox exists right now, not what a stale database remembers. Each check costs 1 credit and takes about 2 seconds.

You get back a status pill plus the details behind it:

StatusWhat to do with it
validSafe to send
invalidRemove it; it will bounce
catch_allThe domain accepts everything, so the mailbox can't be confirmed. Send cautiously.
riskyDeliverable but flagged, for example a role address like info@. Decide per campaign.
disposableA throwaway inbox. Remove it from any long-term list.
unknownThe server wouldn't give a clear answer (greylisting and similar). Re-verify later.

The risk score (0 to 100, lower is safer) combines the SMTP outcome with flags like role account, free provider and catch-all, so you can set your own cutoff instead of trusting a single label.

Clean a bulk list

Open Bulk Lists. You can paste addresses directly or upload a file: CSV, Excel (.xlsx) or JSON, up to 50,000 emails per job. For files, InboxValid auto-detects which column holds the emails; click a different column header in the preview if it guessed wrong. Duplicates and non-email values are dropped before anything is charged.

Credits are held upfront, 1 per email, and anything unused is refunded when the job settles. While the job runs you see a live progress bar and counters. When it finishes you get:

Metrics and charts. Per-status counts with percentages and a breakdown donut so you can judge list quality at a glance, for example "82% valid, 9% invalid, 6% catch-all".

Email search. Rather than scrolling thousands of rows, type any part of an address to look up its exact result, status, risk score and reason.

CSV export. Download all results, or filter the export to one status. "Valid only" gives you a send-ready file for your campaign tool.

Deliverability audits

Clean lists only matter if your own domain is set up to deliver. Open Deliverability, enter a sending domain and InboxValid grades it (A to F) across 8 checks: MX, SPF, DKIM, DMARC, PTR, DNSBL blocklist listing, MTA-STS and BIMI. Each failing check comes with a concrete recommendation, and you get a verdict on whether the domain passes the Gmail, Yahoo and Microsoft bulk-sender requirements. An audit costs 5 credits.

Credits & billing

ActionCost
Verify one email1 credit
Bulk job1 credit per email, unused refunded
Deliverability audit5 credits

Credits never expire and there is no subscription. Buy more under Buy Credits (UPI, card or netbanking via Razorpay); volume tiers lower the per-credit price automatically. History keeps the full ledger: every grant, charge and refund with the balance after each movement, plus an activity trail of everything done on the account.

API keys

The API page in the dashboard manages your keys and includes a quickstart. Create a key, copy it when shown (it appears exactly once) and pass it as a bearer token:

Authorization: Bearer iv_live_...

Everything the dashboard does is available over the API: verify at signup, clean lists from your CRM, watch job progress over SSE and export results as CSV. See the API reference for every endpoint with request and response examples.

Try it on your own list

1,000 free credits cleans a real list, not a demo.

Get started free