Quickstart

The Dropfakes API is organized around predictable JSON requests and responses. It includes email validation endpoints, agent-first routes, public tools, and agent-oriented utility endpoints. The base URL for all endpoints is:

text

https://api.dropfakes.com/api/v1/

Authentication

The current API reference is documented as public. You can send requests directly without an authorization header for the endpoints described in this version of the spec.

First request

Start with the simple email check endpoint when you want a fast disposable-email verdict.

bash

curl -X POST "https://api.dropfakes.com/api/v1/email/check" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "person@example.com"
  }'

Sample response

json

{
  "email": "person@example.com",
  "domain": "example.com",
  "disposable": false,
  "verdict": "allow",
  "riskScore": 0.08,
  "checkedAt": "2026-03-21T10:15:00.000Z"
}

Where to go next

Read Introduction for the full docs map.
Open Email Validation for domain score, simple, detailed, and bulk checks.
Open Agent Validation for token-optimized single and batch endpoints built for AI agents.
Open Tools for public DMARC, SPF, DNS, SSL, and WHOIS utility endpoints.
Open Agent Tools when an LLM needs the same utility workflows with agent-oriented descriptions and responses.
Review Usage, Logs, and Analytics once you are wiring the API into production systems.