Documentation

Introduction

Dropfakes helps you block fake signups, disposable inboxes, and low-quality leads before they enter your product, CRM, or sales pipeline.

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.
  • Validate email lists in bulk.
  • Use agent-first validation endpoints with token-optimized response formats for LLM workflows.
  • 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 the new Agent Validation endpoints for single-email and batch agent workflows.

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" \
   -H "Authorization: dk_live_*****" \
  -d '{
    "email": "person@example.com"
  }'

Continue to Quickstart to make your first request.