API reference · v2
Verify an address in one call.
The NoMoreBounce REST API takes an email address and returns one of four verdicts — deliverable, risky, undeliverable, or unknown — with the syntax, MX and SMTP evidence behind it. Authenticate with a bearer token; 1 credit per verified address.
Authentication
Pass your secret key in the Authorization header. Keep it server-side — never ship it in client code.
Authorization: Bearer nmb_live_8f2c…d91a
POST
/v2/verify
Verify a single email address. Returns a verdict, a confidence score from 0–1, and the individual checks. Costs 1 credit.
Body parameters
email
string
required
The address to verify. Must be a syntactically plausible email.
force
boolean
optional
Bypass the cache and run a fresh SMTP check. Default false.
timeout
integer
optional
Max seconds to wait for the SMTP handshake. Default 15.
Example request
curl -X POST https://api.nomorebounce.com/v2/verify \
-H "Authorization: Bearer nmb_live_…" \
-H "Content-Type: application/json" \
-d '{"email": "marco.rossi@azienda.it"}'
Response · 200 OK
{
"email": "marco.rossi@azienda.it",
"status": "deliverable",
"score": 0.98,
"checks": { "syntax": true, "mx": true, "smtp": true },
"catch_all": false,
"credits_left": 12479
}
Status values
deliverable
Mailbox exists and accepts mail. Safe to send.
undeliverable
Hard bounce — the address rejects mail. Remove it.
risky
Catch-all, role or temporary. Deliverable but lower confidence.
unknown
Mail server unreachable at check time. Not charged on full failure.
All endpoints
POST
/v2/verify
Verify a single address
POST
/v2/verify/batch
Verify up to 50k addresses
GET
/v2/credits
Current credit balance
GET
/v2/lists
List your saved lists
GET
/v2/lists/{id}/stats
Health summary for a list
Rate limits
Free
10 / s
burst 30
Pay as you go
50 / s
burst 150
Volume
Custom
dedicated pool
Pricing
Pay per check. Credits never expire.
1 credit verifies 1 address — single, bulk or API. Start with 1,500 free credits every month.
Free forever
€0
1,500 credits, refreshed monthly
Start free
✓1,500 credits / month
✓Single, bulk & API
✓No credit card required