Quickstart Guide

Get started with nofakemails email validation in under 5 minutes.

Step 1: Get Your API Key

First, sign up for a nofakemails account and generate your API key from the dashboard.

Step 2: Make Your First Request

Once you have your API key, you can start validating emails immediately. Here are examples in multiple languages. For complete examples with error handling, see the Code Examples page.

curl -X GET "https://api.nofakemails.com/v1/email/test@example.com" \
  -H "X-API-Key: your_api_key_here"

Step 3: Understand the Response

The API returns a comprehensive JSON response with validation results:

{
  "email": "test@example.com",
  "valid": true,
  "normalized": "test@example.com",
  "local_part": "test",
  "alias": false,
  "ascii": true,
  "role": null,
  "gibberish": false,
  "gibberish_score": 0.10,
  "domain": "example.com",
  "mx": true,
  "disposable": false,
  "public": false,
  "relay": false,
  "typo": false,
  "typo_suggestion": null
}

Key Response Fields

• valid - Whether the email address has valid format according to RFC 5322
• normalized - Standardized version of the email (lowercase)
• mx - Whether the domain has valid mail servers (MX records)
• disposable - Whether this is a temporary/disposable email service
• public - Whether this is a public email provider (Gmail, Yahoo, etc.)
• relay - Whether this is an email relay/forwarding service
• role - Role category if this is a role-based email (Admin, Support, Sales, etc.)
• typo_suggestion - Suggested correction for common typos (e.g., gmial.com → gmail.com)

For the full list of fields and their types, see the Response Format page.

Next Steps

Now that you have made your first request, you can:

• Explore the complete API reference
• Learn about authentication
• Understand rate limits
• Validate emails in bulk with the batch endpoint
• Browse code examples in your language