Authentication and credits

Direct API requests require an API key. Each verification costs 1 credit. Final Unknown results are refunded automatically.

For /v1 JSON endpoints, send the key as X-Api-Key or apikey query string. Competitor-compatible endpoints use apikey in the URL.

Guest web checks are limited to 5 per day. Free registered accounts receive 50 credits after email confirmation and can run 10 checks per day. Paid accounts are limited by purchased or plan credits.

Statuses

Inboxiqo tracks these statuses across API, web, bulk jobs, proxy logs, and reports: Valid, Invalid, Unknown, CatchAll, Disposable, and Spamtrap.

Base URL

Production API host: api.inboxiqo.com. Local development may use the API project URL configured in launch settings.

High-performance single verification

GET https://api.inboxiqo.com/api/validate_single.php?apikey=API_KEY&email=person@example.com

Example: curl "https://api.inboxiqo.com/api/validate_single.php?apikey=API_KEY&email=person@example.com"

Returns Address, catch_all, Status, Disposable_Domain, Role_Based, Free_Domain, Greylisted, and Diagnosis.

Legacy-compatible single verification

GET https://api.inboxiqo.com/verifier/validate_single/person@example.com/API_KEY

This endpoint returns the same response shape as the high-performance single endpoint.

Get credits

GET https://api.inboxiqo.com/verifier/getcredits/API_KEY

Example response: { "credits": "7800" }

Synchronous bulk verification

POST /v1/email/bulk

Header: X-Api-Key: API_KEY

Request body: { "emails": ["one@example.com", "two@example.com"], "mailFrom": "optional@example.com" }

This endpoint is intended for smaller API batches and is limited by the configured API bulk limit.

Queued JSON bulk jobs

POST /v1/email/bulk/jobs

Header: X-Api-Key: API_KEY

Request body: { "emails": ["one@example.com", "two@example.com"] }

Returns 202 Accepted with a job id. The worker processes the job in the background.

Upload TXT file for bulk verification

POST https://api.inboxiqo.com/verifier/upload_file

Form fields: api_key, filename. Current direct upload support is TXT only, up to 50MB.

Example: curl -F "filename=@/path/to/emails.txt" -F "api_key=API_KEY" "https://api.inboxiqo.com/verifier/upload_file"

Job progress

GET https://api.inboxiqo.com/verifier/file_info/API_KEY/FILE_ID

Returns status_label, ready_for_download, downloadable, progress_percent, phase, percent_phase1, percent_phase2, result_counts, and download URLs.

Poll every 30 to 60 seconds and stop when status_label is completed.

Marketplace usage

RapidAPI and Apify plans may add daily limits, monthly limits, concurrency limits, and marketplace billing rules. Those limits are enforced separately from direct app usage.