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-api

    Every 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 jobs

    If 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.

    Support

    We typically reply in a few hours

    Hi! 👋 How can we help you today?

    Enter your email so we can reply to you: