Quickstart

The Dropfakes API is organized around predictable JSON requests and responses. 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" \
  -H "Authorization: dk_live_*****" \
  -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 the Email Validation group in the sidebar for simple, detailed, and bulk checks.
Open Agent Validation for token-optimized single and batch endpoints built for AI agents.
Review Usage, Logs, and Analytics once you are wiring the API into production systems.