Quickstart

Get up and running with TinyValidator in under 5 minutes.

Prerequisites

• A TinyValidator account (sign up free)
• An API key from your dashboard

Step 1: Get Your API Key

1. Log in to your TinyValidator dashboard
2. Find the API Keys section
3. Click Create Key
4. Copy your key

Important: Keep your API key secret. Never expose it in client-side code.

Step 2: Make Your First Request

Using cURL

curl "https://tinyvalidator.com/api/v1/[email protected]" \
  -H "Authorization: Bearer YOUR_API_KEY"

Using JavaScript

const response = await fetch(
  'https://tinyvalidator.com/api/v1/[email protected]',
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
    },
  }
);

const data = await response.json();
console.log(data);

Using Python

import requests

response = requests.get(
    'https://tinyvalidator.com/api/v1/verify',
    params={'email': '[email protected]'},
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

print(response.json())

Step 3: Understand the Response

A successful response looks like this:

{
  "email": "[email protected]",
  "valid": true,
  "score": 85,
  "deliverability": "high",
  "disposable": false,
  "role_account": false,
  "catch_all": false,
  "free_email": false,
  "syntax_valid": true,
  "domain_valid": true,
  "mailbox_valid": true,
  "provider": "google",
  "mx_host": "gmail-smtp-in.l.google.com.",
  "suggestion": null,
  "dns": null
}

Key Response Fields

Field	Type	Description
valid	boolean	Overall validity (domain exists and not disposable)
score	number	Quality score from 0-100
deliverability	string	Rating: high, medium, low, or risky
disposable	boolean	True if using a disposable email service
suggestion	string | null	Suggested correction for typos

Next Steps

• Learn about Authentication best practices
• Explore the full Verification Guide
• Understand Quality Scores