Email Verifier API
Send us a list of emails, we hand back verified results. Three steps: send the list, wait, get results. 1 credit per email — the same balance you use in the app.
The basics
Base URL
https://yvinpaxnumvgqvkankmc.supabase.co/functions/v1/public-apiEvery request needs your key in a header
Authorization: Bearer ost_live_xxxxxxxxxxxxxxxx- Up to 7,500 emails per job. Duplicates removed before you're charged.
- 1 credit per returned Safe, Risky or Invalid result. Failed or cancelled jobs refund undelivered rows.
- Max 3 jobs running at once.
1Send your emails
curl -X POST https://yvinpaxnumvgqvkankmc.supabase.co/functions/v1/public-api/v1/email-verifier/jobs \
-H "Authorization: Bearer $OS_TOOLS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"emails":["jane@acme.com","john@acme.com"]}'You get a job_id back straight away. Save it.
{
"job_id": "a0328648-48df-4b4f-a88c-64dc6c433357",
"status": "pending",
"total_items": 2,
"credits_charged": 2
}2Wait until it's done
curl https://yvinpaxnumvgqvkankmc.supabase.co/functions/v1/public-api/v1/email-verifier/jobs/JOB_ID \
-H "Authorization: Bearer $OS_TOOLS_API_KEY"Check every 10–15 seconds until status is completed. Other values: pending, processing, failed, cancelled.
3Get your results
curl https://yvinpaxnumvgqvkankmc.supabase.co/functions/v1/public-api/v1/email-verifier/jobs/JOB_ID/results \
-H "Authorization: Bearer $OS_TOOLS_API_KEY"{
"job_id": "...",
"status": "completed",
"results": [
{
"email": "jane@acme.com",
"isValid": true,
"risk": "low",
"score": 95
}
]
}The main field you care about is isValid. If you ask before the job finishes you get a 409 — just keep waiting.
Two extras
GET /v1/credits # how many credits you have left
GET /v1/email-verifier/jobs # your 50 most recent jobsIf something goes wrong
401 — your key is missing, wrong or revoked.
400 — bad list: empty, a malformed address, or over 7,500 emails.
402 Insufficient credits — top up in the app. Nothing was charged.
409 — results aren't ready yet. Keep polling.
429 — you already have 3 jobs running. Wait for one to finish.
503 — our verification provider is briefly down. Nothing was charged; retry shortly.