GET/verify

Verify a single email address

Runs the full check on one address and returns a verdict, a 0-100 score, and the reasons behind them.

verdict is deliverable, risky or undeliverable. didYouMean is populated when the domain looks like a common typo. mxHosts lists the mail exchangers found, in priority order.

$0.003 per call120 req/minFree allowance applies

Request

curl -X GET "https://www.twotic.dev/v1/email-verify/verify" \
  -H "Authorization: Bearer $TWOTIC_KEY"

const res = await fetch("https://www.twotic.dev/v1/email-verify/verify", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.TWOTIC_KEY}`,
  },
})

if (!res.ok) throw new Error(await res.text())

const data = await res.json()
console.log(res.headers.get("X-Twotic-Cost"))

import os, requests

res = requests.get(
    "https://www.twotic.dev/v1/email-verify/verify",
    headers={"Authorization": f"Bearer {os.environ['TWOTIC_KEY']}"},
)
res.raise_for_status()

data = res.json()
print(res.headers["X-Twotic-Cost"])

package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://www.twotic.dev/v1/email-verify/verify", nil)
	req.Header.Set("Authorization", "Bearer "+os.Getenv("TWOTIC_KEY"))

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	out, _ := io.ReadAll(res.Body)
	fmt.Println(string(out))
	fmt.Println(res.Header.Get("X-Twotic-Cost"))
}

<?php
$ch = curl_init("https://www.twotic.dev/v1/email-verify/verify");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => "GET",
    CURLOPT_HTTPHEADER     => [
        "Authorization: Bearer " . getenv("TWOTIC_KEY"),
    ],
]);

$data = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($data);

require "net/http"
require "json"

uri = URI("https://www.twotic.dev/v1/email-verify/verify")
req = Net::HTTP::Get.new(uri)
req["Authorization"] = "Bearer #{ENV.fetch('TWOTIC_KEY')}"

res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(req)
end

puts JSON.parse(res.body)
puts res["X-Twotic-Cost"]

{
  "mcpServers": {
    "email-verify": {
      "type": "http",
      "url": "https://www.twotic.dev/api/mcp/email-verify",
      "headers": { "Authorization": "Bearer tk_live_your_key" }
    }
  }
}

Parameters

query parameters

Name	Type	Required	Description
email	string	required	The address to verify.e.g. dana@example.com

Response

200The verification result.

{
  "email": "dana@example.com",
  "score": 95,
  "domain": "example.com",
  "mxFound": true,
  "mxHosts": [
    "mx1.example.com",
    "mx2.example.com"
  ],
  "reasons": [],
  "verdict": "deliverable",
  "didYouMean": null,
  "disposable": false,
  "roleAccount": false,
  "syntaxValid": true,
  "freeProvider": false
}

As an agent tool

Connect https://www.twotic.dev/api/mcp/email-verify and this endpoint is exposed as the tool email-verify_verify.

Check whether a single email address can receive mail, returning a deliverable/risky/undeliverable verdict with a confidence score and reasons. Choose this before sending to, or accepting, an address you have not used before — it catches dead domains, disposable providers, role accounts and typos like gmial.com. Requires `email`. Use the batch tool for more than a handful of addresses.