ValidReach for Developers

Verify email in your stack with a clear HTTP API

Gate signups and forms with real-time verification. Same result model as the dashboard and list jobs — prepaid credits that stay fair when the answer is unknown.

POST /api/v1/verify/singleBulk verify in one callUnknown results never burn credits100 free starter credits
POST /api/v1/verify/single
{
  "status": "valid",
  "score": 0.95,
  "is_deliverable": true,
  "credits_used": 1
}
deliverablebillable

Same classification as dashboard spot-checks and bulk list jobs.

Why developers choose ValidReach

Built to integrate, not to invent a second data model

Ship verification once. Product, growth, and marketing share deliverable / risky / undeliverable / unknown everywhere.

  • Straightforward HTTP API

    Verify one address or up to 50 per call, upload files for async jobs, and poll or long-poll status. Bearer or X-API-Key auth, JSON in and out.

  • Clear result model

    deliverable, undeliverable, risky, and unknown — plus quality flags for disposable, role, free, and accept-all.

  • Fair credit billing

    Unknown outcomes never consume credits. You fund work you can act on and re-check edge cases later.

  • Keys under your control

    Create and revoke API keys from the dashboard. Keep secrets server-side — never in client forms.

  • Same language as the UI

    Dashboard spot-checks and list jobs match API responses so product and marketing stop arguing about “valid”.

  • Start free, scale with packs

    100 starter credits, then prepaid packs. Volume pricing available when traffic climbs.

Real-time API

One endpoint. Actionable JSON.

POST an email, get a result you can branch on in your form handler — without a second vocabulary for the rest of the product.

  • Gate at capture — Call verify on signup, invite, or lead forms before the address hits your database.
  • Act on flags — Block undeliverable, challenge disposable, or allow with policy — you own the product UX.
  • Bill only when it counts — Unknown is free. Retries and edge cases stay fair while you tune thresholds.
  • Bulk when you need it — Same credit balance powers real-time API calls and CSV list jobs.
Explore the verification API
request
curl -X POST https://your-host/api/v1/verify \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"user@example.com"}'
response
{
  "success": true,
  "code": "0",
  "message": "Success",
  "data": {
    "email": "user@example.com",
    "status": "valid",
    "score": 0.95,
    "is_deliverable": true,
    "is_disposable": false,
    "reason": "accepted",
    "credits_used": 1,
    "retryable": false
  }
}
Bulk list job
Deliverable
Risky
Undeliverable

Same status model as single-email API responses. Unknown rows stay free to re-check.

List verification

Bulk jobs when real-time is not enough

Clean exports and migrations with the same result language you already wire into forms.

  • Batch hygiene jobs — Upload exports, triage undeliverable and risky rows, export only what you intend to send.
  • Consistent classification — List results use the same status model as single-email API responses.
  • Migration and backfill — Clean CRM dumps before an ESP move or re-engagement without inventing a second pipeline.
  • One prepaid balance — API, lists, and dashboard draw from the same credits.
Learn about list verification
Ready to integrate

Create a key and verify your first address

Get 100 free starter credits. Unknown results never burn credits — same model in the API, lists, and UI.

When verification is critical

Moments engineering cannot ship blind

Use real-time gates and list jobs where data quality and reputation are on the line.

Shipping a signup form

Wire verification before launch so typos and fake inboxes never create dead user rows.

Traffic spikes

Keep real-time checks on the hot path so growth experiments do not pollute the user table.

Key rotation

Revoke compromised keys from the dashboard and ship a new secret without redesigning the integration.

Debugging deliverability

Spot-check addresses in the UI with the same result model your API returns in production.

Importing legacy lists

Bulk-verify before you load historical contacts into a new ESP or CRM.

Privacy-minded processing

Process addresses to return a result. Secrets stay server-side; keys stay revocable.

What good looks like

Outcomes engineering teams design for

Illustrative goals — not customer claims. Wire verification so every surface shares one quality bar.

Ship the gate once

One integration path for web, mobile, and backend jobs — same status vocabulary everywhere.

Protect sender reputation

Stop undeliverable rows at the form so product and marketing mail avoid hard-bounce noise.

Predictable cost

Prepaid credits with free unknown results — no surprise bill for inconclusive checks.

Frequently asked questions

Straight answers for engineers evaluating ValidReach.

Built for builders

Ship verification without inventing results

Start free with starter credits. Same results in the dashboard, list jobs, and API — so your integration stays honest at scale.

Prefer a walkthrough? Contact us · API product page