Documentation

Introduction

Dropfakes helps you block fake signups, disposable inboxes, and low-quality leads before they enter your product, CRM, or sales pipeline. The API now covers direct email validation, agent-first workflows, reputation scoring, and DNS or domain utility tools.

What the API is for

The API is built for teams that need fast, machine-readable email risk signals inside product onboarding, signup flows, lead capture forms, and internal operations tooling.

What you can do here

  • Run lightweight disposable-email checks for fast gating.
  • Run detailed email checks that include DNS, SMTP, and reputation signals.
  • Score a domain before you trust the sender behind it.
  • Validate email lists in bulk.
  • Use agent-first validation endpoints with token-optimized response formats for LLM workflows.
  • Generate or inspect DNS records with public tools for DMARC, SPF, DNS, SSL, and WHOIS.
  • Use agent-first tools when an LLM needs DNS, SSL, or WHOIS context during automated investigations.
  • Inspect usage, logs, and analytics endpoints.
  • Access public utility endpoints such as plans and health.

How the docs are organized

Use the Getting Started section for the base URL, request shape, and your first successful call. Use the generated API reference groups in the sidebar for endpoint-level details, parameters, request bodies, and example responses, including Agent Validation, Agent Tools, and public Tools endpoints.

How to read endpoint pages

Every API page includes:

  • a plain-language explanation
  • the full endpoint URL
  • request examples in curl, Go, Python, and JSON
  • parameter and body field tables
  • success and error response examples
bash
curl -X POST "https://api.dropfakes.com/api/v1/email/check" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "person@example.com"
  }'

Continue to Quickstart to make your first request.