DocsDocumentation
Email Verification API
Verify emails via dashboard or API using our external validation service. Each verification consumes credits based on check type.
Quickstart
Verify in minutes
Get an API key, top up credits, then verify from dashboard or API.
1. Get an API Key
From Settings → API Keys in your dashboard. Each user can have one active key at a time.
headers.txt
1apiKey=th_1234567890abcdef2. Top up Credits
Use Dashboard → Credits to add balance. MX check: 0.1 credit, Full check: 0.5 credit.
Credits are consumed per verification and tracked in your account.
3. Verify an Email
Validate email deliverability and format in real time.
Node.js example
verify.js
1import fetch from 'node-fetch';
2
3async function verifyEmail(email, apiKey) {
4 const res = await fetch('https://api.tracemail.xyz/api/check-mail?email=' + encodeURIComponent(email) + '&apiKey=' + encodeURIComponent(apiKey) + '&checkType=full', {
5 method: 'GET'
6 });
7 return res.json();
8}
9
10verifyEmail('[email protected]', 'th_1234567890abcdef').then(console.log);Authentication
Include your API key as a query parameter.
headers.txt
1x-api-key: th_1234567890abcdefBase URL
| Environment | Base URL |
|---|---|
| Production | https://api.tracemail.xyz |
API Reference · Verify Email
Verify email deliverability and format.
request.txt
1GET /api/[email protected]&apiKey=th_1234567890abcdef&checkType=fullParameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| string | Yes | Email address to verify | |
| checkType | string | No | "mx" or "full" (default: "full") |
Response
response.json
1{
2 "email": "[email protected]",
3 "status": "valid",
4 "score": 95,
5 "checkType": "full",
6 "timestamp": "2024-01-01T00:00:00.000Z"
7}Code Examples
Code Examples
Use these snippets to call the verification endpoint from your app.
Node.js
Simple client example
verify.js
1import fetch from 'node-fetch';
2
3async function verifyEmail(email, apiKey) {
4 const res = await fetch('https://api.tracemail.xyz/api/check-mail?email=' + encodeURIComponent(email) + '&apiKey=' + encodeURIComponent(apiKey) + '&checkType=full', {
5 method: 'GET'
6 });
7 return res.json();
8}
9
10verifyEmail('[email protected]', 'th_1234567890abcdef').then(console.log);cURL
Command line example
verify.sh
1curl "https://api.tracemail.xyz/api/[email protected]&apiKey=th_1234567890abcdef&checkType=full"Python
Requests library example
verify.py
1import requests
2
3def verify_email(email, api_key):
4 url = "https://api.tracemail.xyz/api/check-mail"
5 params = {
6 "email": email,
7 "apiKey": api_key,
8 "checkType": "full"
9 }
10
11 response = requests.get(url, params=params)
12 return response.json()
13
14result = verify_email("[email protected]", "th_1234567890abcdef")
15print(result)